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

示例扩展