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