search.search()
使用指定的搜索引擎或默认搜索引擎进行搜索。
结果将显示在一个新的选项卡中,或者如果给出了 tabId 参数,则显示在由此标识的选项卡中。
要在扩展程序中使用此功能,你必须要求"search"
有明确许可.
获取安装的搜索引擎,请使用 search.get()
(en-US).
语法
js
browser.search.search(
searchProperties, // object
);
参数
searchProperties
-
object
. 拥有以下属性的对象:query
-
字符串
. 进行查询的内容。 engine
可选-
字符串。
.搜索引擎的名称。如果指定的搜索引擎名称不存在,该函数将引发错误。如果省略此属性,则使用默认的搜索引擎。 tabId
可选-
整型。用于显示搜索结果的选项卡。如果省略此属性,搜索结果将显示在新选项卡中。
返回值
无。
浏览器兼容性
BCD tables only load in the browser
示例
使用默认搜索引擎进行搜索。结果显示在新选项卡中:
js
function search() {
browser.search.search({
query: "styracosaurus",
});
}
browser.browserAction.onClicked.addListener(search);
使用维基百科进行搜索。结果显示在新选项卡中:
js
function search() {
browser.search.search({
query: "styracosaurus",
engine: "Wikipedia (en)",
});
}
browser.browserAction.onClicked.addListener(search);
使用维基百科进行搜索。结果将显示在活动选项卡中:
js
function search(tab) {
browser.search.search({
query: "styracosaurus",
engine: "Wikipedia (en)",
tabId: tab.id,
});
}
browser.browserAction.onClicked.addListener(search);