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

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 durchfü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 im aktuellen Tab (Standard):

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

browser.browserAction.onClicked.addListener(search);

Eine Suche mit den Ergebnissen in einem neuen Fenster:

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

browser.browserAction.onClicked.addListener(search);

Eine Suche mit den Ergebnissen in einem bestimmten Tab:

js
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