browser.extension

Beschreibung

Die chrome.extension API enthält Dienstprogramme, die von jeder Erweiterungsseite verwendet werden können. Sie unterstützt den Austausch von Nachrichten zwischen einer Erweiterung und ihren Inhaltsskripts oder zwischen Erweiterungen, wie im Artikel Message Passing ausführlich beschrieben.

Typen

ViewType

Chrome 44 und höher browser.* seit Chrome 148

Der Typ der Erweiterungsansicht.

Enum

"tab"

"popup"

Attribute

inIncognitoContext

„True“ für Inhaltsskripts, 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 „split“-incognito_behavior.

Typ

boolean

Methoden

getBackgroundPage()

Nur im Vordergrund 
browser.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 | undefined

getViews()

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

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

Parameter

  • fetchProperties

    Objekt optional

    • tabId

      number optional

      Chrome 54 oder höher browser.* seit Chrome 148

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

    • Typ

      ViewType optional

      Der Typ der abzurufenden Ansicht. Wenn nicht angegeben, werden alle Ansichten zurückgegeben (einschließlich Hintergrundseiten und Tabs).

    • windowId

      number optional

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

Ausgabe

  • Window[]

    Array globaler Objekte

isAllowedFileSchemeAccess()

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

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

Ausgabe

  • Promise<boolean>

    Chrome 99 und höher browser.* seit Chrome 148

isAllowedIncognitoAccess()

browser.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 browser.* seit Chrome 148

setUpdateUrlData()

browser.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