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 diese spezielle Suchmaschine für eine Suche zu nutzen.
Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.
Syntax
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. Zu jedem Zeitpunkt kann nur eine Suchmaschine die Standard-Suchmaschine sein. aliasOptional-
string. Falls eine Suchmaschine ein Alias hat, kann der Benutzer mit einer bestimmten Suchmaschine suchen, indem er den Alias in der 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. favIconUrlOptional-
string. Das Icon der Suchmaschine, als data: URL.
Beispiele
Erhalten Sie alle installierten Suchmaschinen:
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
Browser-Kompatibilität
Loading…