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

擴充套件程式示例

瀏覽器相容性