search.query()

Führen Sie eine Suche mit der Standardsuchmaschine des Browsers durch.

Die Ergebnisse werden entsprechend der disposition-Eigenschaft oder im Tab, der in der tabId-Eigenschaft angegeben ist, im aktuellen Tab, einem neuen Tab oder einem neuen Fenster angezeigt. Wenn keines von beiden angegeben ist, werden die Ergebnisse im aktuellen Tab angezeigt.

Um diese Funktion zu verwenden, muss Ihre Erweiterung die "search" Manifest-Berechtigung besitzen.

Syntax

js
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 sind CURRENT_TAB, NEW_TAB und NEW_WINDOW. Standardmäßig CURRENT_TAB. Kann nicht zusammen mit tabId angegeben werden.

tabId Optional

integer. Eine optionale Kennung für den Tab, in dem Sie die Suche ausführen möchten. Wenn diese Eigenschaft weggelassen wird, werden die Suchergebnisse in einem neuen Tab angezeigt. Kann nicht zusammen mit disposition angegeben werden.

text

string. Die Suchanfrage.

Rückgabewert

Keiner.

Beispiele

Eine Suche mit den Ergebnissen, die im aktuellen Tab angezeigt werden (Standard):

js
function search() {
  browser.search.query({
    text: "styracosaurus",
  });
}

browser.browserAction.onClicked.addListener(search);

Eine Suche mit den Ergebnissen, die in einem neuen Fenster angezeigt werden:

js
function search() {
  browser.search.query({
    text: "styracosaurus",
    disposition: "NEW_WINDOW",
  });
}

browser.browserAction.onClicked.addListener(search);

Eine Suche mit den Ergebnissen, die in einem bestimmten Tab angezeigt werden:

js
function search(tab) {
  browser.search.query({
    query: "styracosaurus",
    tabId: tab.id,
  });
}

browser.browserAction.onClicked.addListener(search);

Browser-Kompatibilität