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