chrome.extensionTypes

Aktualisierungsdatum: 2026-09-25 robots: noindex

Beschreibung

Die chrome.extensionTypes API enthält Typdeklarationen für Chrome-Erweiterungen.

Typen

ColorArray

Chrome 139 und höher

Typ

[number, number, number, number]

CSSOrigin

Chrome 66 und höher

Der Ursprung des eingefügten CSS.

Enum

"author"

"user"

DeleteInjectionDetails

Chrome 87 und höher

Details zum zu entfernenden CSS. Entweder der Code oder die Dateieigenschaft muss festgelegt werden, aber nicht beide gleichzeitig.

Attribute

  • allFrames

    Boolesch optional

    Wenn „allFrames“ true ist, bedeutet das, dass das CSS aus allen Frames der aktuellen Seite entfernt werden soll. Standardmäßig ist es false und wird nur aus dem oberen Frame entfernt. Wenn true und frameId festgelegt sind, wird der Code aus dem ausgewählten Frame und allen untergeordneten Frames entfernt.

  • Code

    String optional

    Zu entfernender CSS-Code.

  • cssOrigin

    CSSOrigin optional

    Der Ursprung des zu entfernenden CSS. Die Standardeinstellung ist "author".

  • Datei

    String optional

    Die zu entfernende CSS-Datei.

  • frameId

    number optional

    Der Frame, aus dem das CSS entfernt werden soll. Der Standardwert ist 0 (der Frame der obersten Ebene).

  • matchAboutBlank

    Boolesch optional

    Wenn „matchAboutBlank“ auf „true“ gesetzt ist, wird der Code auch aus „about:blank“- und „about:srcdoc“-Frames entfernt, wenn Ihre Erweiterung Zugriff auf das übergeordnete Dokument hat. Der Standardwert ist false.

DocumentLifecycle

Chrome 106 und höher

Der Dokumentlebenszyklus des Frames.

Enum

„prerender“

„active“

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 und höher

Die JavaScript-Umgebung, in der ein Skript ausgeführt werden soll. Kann entweder eine isolierte Welt sein, die nur für diese Erweiterung gilt, die Hauptwelt des DOM, die mit dem JavaScript der Seite geteilt wird, oder eine Welt für Nutzerskripts, die nur für Skripts verfügbar ist, die mit der User Scripts API registriert wurden.

Enum

„ISOLATED“

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106 und höher

Der Typ des Frames.

Enum

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139 und höher

Pixeldaten für ein Bild. Muss ein ImageData-Objekt sein, z. B. aus einem canvas-Element.

Typ

ImageData

ImageDetails

Details zu Format, Qualität und Bereich eines Bildes.

Attribute

  • Format

    ImageFormat optional

    Das Format des resultierenden Bildes. Standardwert ist "jpeg".

  • Qualität

    number optional

    Wenn das Format "jpeg" ist, wird die Qualität des resultierenden Bildes gesteuert. Dieser Wert wird für PNG-Bilder ignoriert. Wenn die Qualität verringert wird, weist das resultierende Bild mehr visuelle Artefakte auf und die Anzahl der zum Speichern erforderlichen Bytes wird verringert.

ImageFormat

Chrome 44 und höher

Das Format eines Bildes.

Enum

"jpeg"

"png"

InjectDetails

Details zum einzufügenden Skript oder CSS. Entweder der Code oder die Dateieigenschaft muss festgelegt werden, aber nicht beide gleichzeitig.

Attribute

  • allFrames

    Boolesch optional

    Wenn „allFrames“ true ist, bedeutet das, dass das JavaScript oder CSS in alle Frames der aktuellen Seite eingefügt werden soll. Standardmäßig ist es false und wird nur in den oberen Frame eingefügt. Wenn true und frameId festgelegt sind, wird der Code in den ausgewählten Frame und alle untergeordneten Frames eingefügt.

  • Code

    String optional

    JavaScript- oder CSS-Code, der eingefügt werden soll.

    Warnung:Seien Sie vorsichtig, wenn Sie den Parameter code verwenden. Eine falsche Verwendung kann Ihre Erweiterung für Cross-Site-Scripting-Angriffe anfällig machen.

  • cssOrigin

    CSSOrigin optional

    Chrome 66 und höher

    Der Ursprung des einzufügenden CSS. Dies kann nur für CSS, nicht für JavaScript angegeben werden. Die Standardeinstellung ist "author".

  • Datei

    String optional

    JavaScript- oder CSS-Datei, die eingefügt werden soll.

  • frameId

    number optional

    Chrome 50 und höher

    Der Frame, in den das Skript oder CSS eingefügt werden soll. Der Standardwert ist 0 (der Frame der obersten Ebene).

  • matchAboutBlank

    Boolesch optional

    Wenn „matchAboutBlank“ auf „true“ gesetzt ist, wird der Code auch in „about:blank“- und „about:srcdoc“-Frames eingefügt, wenn Ihre Erweiterung Zugriff auf das übergeordnete Dokument hat. Code kann nicht in Frames der obersten Ebene vom Typ „about:“ eingefügt werden. Der Standardwert ist false.

  • runAt

    RunAt optional

    Der frühestmögliche Zeitpunkt, zu dem das JavaScript oder CSS in den Tab eingefügt wird. Der Standardwert ist „document_idle“.

RunAt

Chrome 44 und höher

Der frühestmögliche Zeitpunkt, zu dem das JavaScript oder CSS in den Tab eingefügt wird.

Enum

„document_start“
Das Script wird nach allen Dateien aus CSS, aber vor dem Erstellen von anderem DOM oder dem Ausführen anderer Scripts eingefügt.

„document_end“
Das Script wird unmittelbar nach dem Abschluss des DOM eingefügt, aber bevor untergeordnete Ressourcen wie Bilder und Frames geladen wurden.

document_idle
Der Browser wählt einen Zeitpunkt für das Einschleusen des Skripts zwischen „document_end“ und unmittelbar nach dem Auslösen des window.onload-Ereignisses aus. Der genaue Zeitpunkt des Einfügens hängt davon ab, wie komplex das Dokument ist und wie lange es dauert, bis es geladen wird. Er wird für die Seitenaufbaugeschwindigkeit optimiert. Content-Scripts, die unter „document_idle“ ausgeführt werden, müssen nicht auf das window.onload-Ereignis warten. Sie werden garantiert nach dem DOM-Abschluss ausgeführt. Wenn ein Script unbedingt nach window.onload ausgeführt werden muss, kann die Erweiterung mit der Property document.readyState prüfen, ob onload bereits ausgelöst wurde.