search.get()
获取所有已安装搜索引擎的数组。
每个返回的搜索引擎都使用一个名称进行标识,您可以将该名称传递给 search.search()
以使用该特定引擎进行搜索。
这是一个异步函数,它返回一个 Promise
。
语法
js
let gettingEngines = browser.search.get()
参数
无。
返回值
一个 Promise
,它将使用一个 数组 来填充搜索引擎对象。每个搜索引擎对象可能包含以下属性
name
-
string
。搜索引擎的名称。 isDefault
-
boolean
。如果搜索引擎是默认引擎,则为true
。在任何给定时间,只能有一个搜索引擎是默认引擎。 alias
可选-
string
。如果搜索引擎有别名,用户可以通过在地址栏中输入别名(在搜索词之前)来使用特定搜索引擎进行搜索。例如,如果维基百科引擎的别名为 "wk",用户可以通过在地址栏中输入 "wk pandas" 来搜索维基百科中的熊猫。别名有时也被称为 "关键词"。 favIconUrl
可选-
string
。搜索引擎的图标,以 data: URL 的形式表示。
浏览器兼容性
BCD 表格仅在浏览器中加载
示例
获取所有已安装搜索引擎
js
function retrieved(results) {
console.log(`There were: ${results.length} search engines retrieved.`);
for (const searchEngine of results) {
console.log(JSON.stringify(searchEngine.name));
}
}
browser.search.get().then(retrieved);