search.query()
使用浏览器默认的搜索引擎执行搜索。
搜索结果根据 disposition
属性显示在当前标签页、新标签页或新窗口中,或者显示在 tabId
属性指定的标签页中。如果两者都没有指定,则结果显示在当前标签页中。
要使用此函数,您的扩展必须具有 "search"
manifest 权限。
语法
js
browser.search.query(
queryInfo // object
)
参数
queryInfo
-
object
。一个具有以下属性的对象。disposition
可选-
string
。搜索结果显示的位置。有效值为CURRENT_TAB
、NEW_TAB
和NEW_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);
浏览器兼容性
加载中…