chrome.extensionTypes

Beschreibung

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

Typen

ColorArray

Ausstehend

Typ

[number, number, number, number]

CSSOrigin

Chrome 66 und höher

Der Ursprung des eingeschleusten CSS.

Enum

"author"

„user“

DeleteInjectionDetails

Chrome 87 und höher

Details zum zu entfernenden CSS. Es muss entweder die Code- oder die Dateieigenschaft festgelegt werden, aber nicht beide gleichzeitig.

Attribute

  • allFrames

    boolescher Wert optional

    Wenn „allFrames“ true ist, bedeutet das, dass das CSS aus allen Frames der aktuellen Seite entfernt werden soll. Standardmäßig ist das 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

    CSS-Code, der entfernt werden soll.

  • 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. Standardmäßig ist „0“ (Frame der obersten Ebene) festgelegt.

  • matchAboutBlank

    boolescher Wert optional

    Wenn „matchAboutBlank“ auf „wahr“ gesetzt ist, wird der Code auch aus den Frames „about:blank“ und „about:srcdoc“ 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 Script ausgeführt werden soll. Dies 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 sind.

Enum

ISOLIERT

„MAIN“

"USER_SCRIPT"

FrameType

Chrome 106 und höher

Der Frame-Typ.

Enum

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Ausstehend

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

Typ

ImageData

ImageDetails

Details zum Format und zur Qualität eines Bildes.

Attribute

  • Format

    ImageFormat optional

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

  • Qualität

    number optional

    Wenn das Format "jpeg" ist, steuert dies die Qualität des resultierenden Bilds. Bei PNG-Bildern wird dieser Wert ignoriert. Je niedriger die Qualität ist, desto mehr visuelle Artefakte enthält das resultierende Bild und desto weniger Byte sind zum Speichern erforderlich.

ImageFormat

Chrome 44 und höher

Das Format eines Bildes.

Enum

„jpeg“

"png"

InjectDetails

Details zum einzuschleusenden Script oder CSS. Es muss entweder die Code- oder die Dateieigenschaft festgelegt werden, aber nicht beide gleichzeitig.

Attribute

  • allFrames

    boolescher Wert 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 das 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:Verwenden Sie den Parameter code mit Bedacht. Eine falsche Verwendung kann Ihre Erweiterung für Cross-Site-Scripting-Angriffe öffnen.

  • cssOrigin

    CSSOrigin optional

    Chrome 66 und höher

    Die Quelle des einzuschleusenden CSS. Diese Option 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 Script oder CSS eingefügt werden soll. Standardmäßig ist „0“ (Frame der obersten Ebene) festgelegt.

  • matchAboutBlank

    boolescher Wert optional

    Wenn „matchAboutBlank“ auf „wahr“ 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 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. Standardmäßig ist „document_idle“ festgelegt.

RunAt

Chrome 44 und 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 Dateien aus CSS eingefügt, aber bevor ein anderes DOM erstellt oder ein anderes Script ausgeführt wird.

„document_end“
Das Script wird unmittelbar nach Abschluss des DOMs, aber vor dem Laden von untergeordneten Ressourcen wie Bildern und Frames eingefügt.

„document_idle“
Der Browser wählt einen Zeitpunkt aus, um das Script zwischen „document_end“ und unmittelbar nach dem Auslösen des Ereignisses window.onload einzuschleusen. Der genaue Zeitpunkt der Einfügung hängt davon ab, wie komplex das Dokument ist und wie lange es zum Laden benötigt. Er wird für die Seitenladezeit optimiert. Bei Inhaltsscripts, die bei „document_idle“ ausgeführt werden, muss nicht auf das Ereignis window.onload gewartet werden. Sie werden garantiert nach Abschluss des DOM ausgeführt. Wenn ein Script unbedingt nach window.onload ausgeführt werden muss, kann die Erweiterung mithilfe der Property document.readyState prüfen, ob onload bereits ausgelöst wurde.