search.query()

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

搜索结果根据 disposition 属性显示在当前标签页、新标签页或新窗口中,或者显示在 tabId 属性指定的标签页中。如果两者都没有指定,则结果显示在当前标签页中。

要使用此函数,您的扩展必须具有 "search" manifest 权限

语法

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

参数

queryInfo

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

disposition 可选

string。搜索结果显示的位置。有效值为 CURRENT_TABNEW_TABNEW_WINDOW。默认为 CURRENT_TAB。不能与 tabId 同时指定。

tabId 可选

integer。要在其中执行搜索的标签页的可选标识符。如果省略此属性,搜索结果将显示在新标签页中。不能与 disposition 同时指定。

文本

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);

浏览器兼容性