search.search()
使用指定的搜索引擎或默认搜索引擎进行搜索。
结果将显示在一个新的选项卡中,或者如果给出了 tabId 参数,则显示在由此标识的选项卡中。
要在扩展程序中使用此功能,你必须要求"search"
有明确许可.
获取安装的搜索引擎,请使用 search.get()
.
语法
js
browser.search.search(
searchProperties, // object
);
参数
searchProperties
-
object
. 拥有以下属性的对象:
返回值
无。
浏览器兼容性
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
search | |||||||
searchProperties | |||||||
searchProperties.disposition | |||||||
searchProperties.engine | |||||||
searchProperties.query | |||||||
searchProperties.tabId |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
示例
使用默认搜索引擎进行搜索。结果显示在新选项卡中:
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);