search.query()
Führen Sie eine Suche mit der Standardsuchmaschine des Browsers durch.
Die Ergebnisse werden je nach disposition
-Eigenschaft im aktuellen Tab, einem neuen Tab oder einem neuen Fenster angezeigt oder im Tab, der in der tabId
-Eigenschaft angegeben ist. Wenn keiner angegeben ist, werden die Ergebnisse im aktuellen Tab angezeigt.
Um diese Funktion zu verwenden, muss Ihre Erweiterung die "search"
Manifest-Berechtigung besitzen.
Syntax
browser.search.query(
queryInfo // object
)
Parameter
queryInfo
-
object
. Ein Objekt mit den folgenden Eigenschaften:disposition
Optional-
string
. Der Ort, an dem die Suchergebnisse angezeigt werden. Gültige Werte sindCURRENT_TAB
,NEW_TAB
undNEW_WINDOW
. StandardmäßigCURRENT_TAB
. Kann nicht zusammen mittabId
angegeben werden. tabId
Optional-
integer
. Eine optionale Kennung für den Tab, in dem Sie die Suche durchführen möchten. Wenn diese Eigenschaft weggelassen wird, werden die Suchergebnisse in einem neuen Tab angezeigt. Kann nicht zusammen mitdisposition
angegeben werden. text
-
string
. Die Suchanfrage.
Rückgabewert
Keiner.
Beispiele
Eine Suche mit den Ergebnissen im aktuellen Tab (Standard):
function search() {
browser.search.query({
text: "styracosaurus",
});
}
browser.browserAction.onClicked.addListener(search);
Eine Suche mit den Ergebnissen in einem neuen Fenster:
function search() {
browser.search.query({
text: "styracosaurus",
disposition: "NEW_WINDOW",
});
}
browser.browserAction.onClicked.addListener(search);
Eine Suche mit den Ergebnissen in einem bestimmten Tab:
function search(tab) {
browser.search.query({
query: "styracosaurus",
tabId: tab.id,
});
}
browser.browserAction.onClicked.addListener(search);
Browser-Kompatibilität
BCD tables only load in the browser