search.get()

Erhält ein Array aller installierten Suchmaschinen.

Jede zurückgegebene Suchmaschine wird mit einem Namen identifiziert, den Sie in search.search() übergeben können, um mit dieser speziellen Suchmaschine eine Suche auszuführen.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let gettingEngines = browser.search.get()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit einem Array von Suchmaschinenobjekten erfüllt wird. Jedes Suchmaschinenobjekt kann die folgenden Eigenschaften enthalten:

name

string. Der Name der Suchmaschine.

isDefault

boolean. true, wenn die Suchmaschine die Standard-Suchmaschine ist. Es kann zu einem bestimmten Zeitpunkt nur eine Standard-Suchmaschine geben.

alias Optional

string. Wenn eine Suchmaschine ein Alias hat, kann der Benutzer mit einer bestimmten Suchmaschine suchen, indem er den Alias in die Adressleiste vor dem Suchbegriff eingibt. Zum Beispiel, wenn die Wikipedia-Suchmaschine den Alias „wk“ hat, kann der Benutzer Wikipedia nach Pandas durchsuchen, indem er „wk pandas“ in die Adressleiste eingibt. Der Alias wird manchmal auch als „Schlüsselwort“ bezeichnet.

favIconUrl Optional

string. Das Icon der Suchmaschine, als eine data: URL.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Erhalten Sie alle installierten Suchmaschinen:

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

Beispielerweiterungen