search.search()

使用指定的搜索引擎或默认搜索引擎进行搜索。

结果将显示在一个新的选项卡中，或者如果给出了 tabId 参数，则显示在由此标识的选项卡中。

要在扩展程序中使用此功能，你必须要求"search" 有明确许可.

获取安装的搜索引擎，请使用 search.get() (en-US).

语法

browser.search.search(
  searchProperties, // object
);

参数

searchProperties

object. 拥有以下属性的对象：

query: 字符串. 进行查询的内容。
engine可选: 字符串。.搜索引擎的名称。如果指定的搜索引擎名称不存在，该函数将引发错误。如果省略此属性，则使用默认的搜索引擎。
tabId可选: 整型。用于显示搜索结果的选项卡。如果省略此属性，搜索结果将显示在新选项卡中。

返回值

无。

浏览器兼容性

BCD tables only load in the browser

示例

使用默认搜索引擎进行搜索。结果显示在新选项卡中：

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

browser.browserAction.onClicked.addListener(search);

使用维基百科进行搜索。结果显示在新选项卡中：

function search() {
  browser.search.search({
    query: "styracosaurus",
    engine: "Wikipedia (en)",
  });
}

browser.browserAction.onClicked.addListener(search);

使用维基百科进行搜索。结果将显示在活动选项卡中：

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

browser.browserAction.onClicked.addListener(search);

Example extensions

menu-search