chrome.search

Beschreibung

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

Berechtigungen

search

Verfügbarkeit

Chrome (ab Version 87)

Typen

Disposition

Enum

"CURRENT_TAB"
Gibt an, dass die Suchergebnisse im Aufruf-Tab oder auf dem 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

    Zahl optional

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

  • Text

    String

    String für die Abfrage mit dem Standardsuchanbieter.

Methoden

query()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.search.query(
  queryInfo: QueryInfo,
  callback?: function,
)

Wird für die Abfrage des Standardsuchanbieters verwendet. Bei einem Fehler wird runtime.lastError festgelegt.

Parameter

  • queryInfo

    QueryInfo

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Versprechen<void>

    Chrome 96 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.