chrome.extensionTypes

refresh date: 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

[Zahl, Zahl, Zahl, Zahl]

CSSOrigin

Chrome 66 oder höher

Der Ursprung des eingefügten CSS.

Enum

"author"

"user"

DeleteInjectionDetails

Chrome 87 oder höher

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

Attribute

• allFrames

  Boolesch optional

  Wenn „allFrames“ auf true gesetzt ist, wird das CSS aus allen Frames der aktuellen Seite entfernt. Standardmäßig ist dies false und wird nur aus dem obersten 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

  Zu entfernende CSS-Datei.

• frameId

  number optional

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

• matchAboutBlank

  Boolesch optional

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

DocumentLifecycle

Chrome 106 oder höher

Der Dokumentlebenszyklus des Frames.

Enum

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111+

Die JavaScript-Welt, in der ein Script 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 Nutzerscripts, die nur für Scripts verfügbar ist, die mit der User Scripts API registriert wurden.

Enum

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106 oder 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 Byte, die zum Speichern erforderlich sind, nimmt ab.

ImageFormat

Chrome 44 oder höher

Das Format eines Bildes.

Enum

"jpeg"

"png"

InjectDetails

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

Attribute

• allFrames

  Boolesch optional

  Wenn „allFrames“ auf true gesetzt ist, bedeutet das, dass das JavaScript oder CSS in alle Frames der aktuellen Seite eingefügt werden soll. Standardmäßig ist dies false und wird nur in den obersten 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 dazu führen, dass Ihre Erweiterung anfällig für Cross-Site-Scripting-Angriffe wird.

• cssOrigin

  CSSOrigin optional

  Chrome 66 oder 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 oder höher

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

• matchAboutBlank

  Boolesch optional

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

• runAt

  RunAt optional

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

RunAt

Chrome 44 oder höher

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

Enum

"document_start"
Das Script wird nach allen CSS-Dateien eingefügt, aber bevor ein anderes DOM erstellt oder ein anderes Script ausgeführt wird.

"document_end"
Das Script wird sofort nach Fertigstellung des DOM eingefügt, aber bevor Unterressourcen wie Bilder und Frames geladen wurden.

"document_idle"
Der Browser wählt einen Zeitpunkt für das Einfügen des Scripts zwischen „document_end“ und unmittelbar nach dem Auslösen des window.onload-Ereignisses aus. Der genaue Zeitpunkt der Einfügung hängt von der Komplexität des Dokuments und der Ladezeit ab und ist für die Seitenaufbaugeschwindigkeit optimiert. Inhaltsskripts, die bei „document_idle“ ausgeführt werden, müssen nicht auf das Ereignis window.onload warten. Sie werden garantiert nach Abschluss des DOM 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.