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);

扩展程序示例

浏览器兼容性