chrome.extension

Beschreibung

Die chrome.extension API enthält Dienstprogramme, die von jeder Erweiterungsseite verwendet werden können. Sie bietet Unterstützung für den Austausch von Nachrichten zwischen einer Erweiterung und ihren Inhaltskripten oder zwischen Erweiterungen, wie in Message Passing ausführlich beschrieben.

Typen

ViewType

Chrome 44 und höher

Der Typ der Erweiterungsansicht.

Enum

"tab"

"popup"

Attribute

inIncognitoContext

Gilt für Content-Skripts, die in Inkognitotabs ausgeführt werden, und für Erweiterungsseiten, die in einem Inkognitoprozess ausgeführt werden. Letzteres gilt nur für Erweiterungen mit dem Inkognitomodus-Verhalten „split“.

Typ

boolean

Methoden

getBackgroundPage()

Nur im Vordergrund 
chrome.extension.getBackgroundPage(): Window | undefined

Gibt das JavaScript-Objekt „window“ für die Hintergrundseite zurück, die in der aktuellen Erweiterung ausgeführt wird. Gibt „null“ zurück, wenn die Erweiterung keine Hintergrundseite hat.

Ausgabe

  • Fenster | nicht definiert

getViews()

Nur im Vordergrund 
chrome.extension.getViews(
  fetchProperties?: object,
): Window[]

Gibt ein Array der JavaScript-„window“-Objekte für jede der Seiten zurück, die in der aktuellen Erweiterung ausgeführt werden.

Parameter

  • fetchProperties

    object optional

    • tabId

      number optional

      Chrome 54 und höher

      Ansicht anhand einer Tab-ID suchen Wenn dieses Feld weggelassen wird, werden alle Ansichten zurückgegeben.

    • Typ

      ViewType optional

      Der abzurufende Ansichtstyp. Wenn ausgelassen, werden alle Ansichten zurückgegeben (einschließlich Hintergrundseiten und ‑tabs).

    • windowId

      number optional

      Das Zeitfenster, auf das die Suche beschränkt werden soll. Wenn ausgelassen, werden alle Ansichten zurückgegeben.

Ausgabe

  • Window[]

    Array globaler Objekte

isAllowedFileSchemeAccess()

chrome.extension.isAllowedFileSchemeAccess(): Promise<boolean>

Ruft den Status des Zugriffs der Erweiterung auf das Schema „file://“ ab. Dies entspricht der Einstellung „Zugriff auf Datei-URLs zulassen“ für jede Erweiterung, die Nutzer über die Seite „chrome://extensions“ verwalten können.

Ausgabe

  • Promise<boolean>

    Chrome 99 und höher

isAllowedIncognitoAccess()

chrome.extension.isAllowedIncognitoAccess(): Promise<boolean>

Ruft den Status des Zugriffs der Erweiterung auf den Inkognitomodus ab. Dies entspricht der vom Nutzer gesteuerten Einstellung „Im Inkognitomodus zulassen“ für jede Erweiterung, die über die Seite „chrome://extensions“ aufgerufen werden kann.

Ausgabe

  • Promise<boolean>

    Chrome 99 und höher

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
): void

Legt den Wert des CGI-Parameters „ap“ fest, der in der Update-URL der Erweiterung verwendet wird. Dieser Wert wird für Erweiterungen ignoriert, die in der Chrome-Erweiterungsgalerie gehostet werden.

Parameter

  • Daten

    String

Ereignisse