search.query()

使用浏览器的默认搜索引擎执行搜索。

根据disposition属性或在tabId属性中指定的选项卡中，结果显示在当前选项卡、新选项卡或新窗口中。如果两者都没有指定，则结果显示在当前选项卡中。

要使用此功能，您的扩展必须具有"search"清单权限。

语法

js
browser.search.query(
  queryInfo             // object
)

参数

queryInfo

object. 一个具有以下属性的对象

disposition 可选

string. 显示搜索结果的位置。有效值为CURRENT_TAB、NEW_TAB和NEW_WINDOW。默认为CURRENT_TAB。不能与tabId一起指定。

tabId 可选

integer. 您想要在其中执行搜索的选项卡的可选标识符。如果省略此属性，则搜索结果将显示在新选项卡中。不能与disposition一起指定。

text

string. 搜索查询。

返回值

无。

示例

在当前选项卡中显示结果的搜索（默认）

js
function search() {
  browser.search.query({
    text: "styracosaurus",
  });
}

browser.browserAction.onClicked.addListener(search);

在新窗口中显示结果的搜索

js
function search() {
  browser.search.query({
    text: "styracosaurus",
    disposition: "NEW_WINDOW",
  });
}

browser.browserAction.onClicked.addListener(search);

在特定选项卡中显示结果的搜索

js
function search(tab) {
  browser.search.query({
    query: "styracosaurus",
    tabId: tab.id,
  });
}

browser.browserAction.onClicked.addListener(search);

浏览器兼容性

BCD 表格仅在浏览器中加载