chrome.search

refresh date: 2026-09-25 robots: noindex

Beschreibung

Verwenden Sie die chrome.search API, um über den Standardanbieter zu suchen.

Berechtigungen

search

Verfügbarkeit

Chrome 87 oder höher

Typen

Disposition

Enum

"CURRENT_TAB"
Gibt an, dass die Suchergebnisse im aufrufenden Tab oder im Tab des aktiven Browsers angezeigt werden.

"NEW_TAB"
Gibt an, dass die Suchergebnisse in einem neuen Tab angezeigt werden.

"NEW_WINDOW"
Gibt an, dass die Suchergebnisse in einem neuen Fenster angezeigt werden.

QueryInfo

Attribute

  • disposition

    Disposition optional

    Ort, an dem Suchergebnisse angezeigt werden sollen. Standardmäßig ist CURRENT_TAB ausgewählt.

  • tabId

    number optional

    Ort, an dem Suchergebnisse angezeigt werden sollen. tabId kann nicht mit disposition verwendet werden.

  • Text

    String

    String, der mit dem Standardsuchanbieter abgefragt werden soll.

Methoden

query()

Promise 
chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
): Promise<void>

Wird verwendet, um den Standardsuchanbieter abzufragen. Im Falle eines Fehlers wird runtime.lastError festgelegt.

Parameter

  • queryInfo

    QueryInfo

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 96 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.