search.query()

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

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

Um diese Funktion zu nutzen, 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 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 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