search.search()

翻译不完整。 请帮助我们翻译这篇文章!

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

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

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

获取安装的搜索引擎, 请使用 search.get().

语法

browser.search.search(
  searchProperties       // object
)

参数

searchProperties

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

query
字符串. 进行查询的内容。
engine可选

字符串。.搜索引擎的名称。 如果指定的搜索引擎名称不存在,该函数将引发错误。 如果省略此属性,则使用默认的搜索引擎。

tabId可选

整型。用于显示搜索结果的选项卡。如果省略此属性,搜索结果将显示在新选项卡中。

返回值

无.

浏览器兼容

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaSafariFirefox for Android
searchChrome No support NoEdge No support NoFirefox Full support 63Opera No support NoSafari No support NoFirefox Android No support No

Legend

Full support  
Full support
No support  
No support

例子

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

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