chrome.extensionTypes

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 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 beides gleichzeitig.

Attribute

  • allFrames

    boolean 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

    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

    boolean 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. 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 Nutzerskripts, die nur für Skripts verfügbar ist, die mit der User Scripts API registriert sind.

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, enthält das resultierende Bild mehr visuelle Artefakte und die Anzahl der zum Speichern benötigten 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 beides gleichzeitig.

Attribute

  • allFrames

    boolean 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 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 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

    boolean 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 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 Skript wird nach allen CSS-Dateien, aber vor dem Erstellen von DOM-Elementen oder dem Ausführen anderer Skripts eingefügt.

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

„document_idle“
Der Browser wählt einen Zeitpunkt für das Einfügen 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 Seitenladezeit optimiert. Inhalts-Scripts, die unter „document_idle“ ausgeführt werden, müssen nicht auf das window.onload-Ereignis warten. Sie werden garantiert nach Abschluss des DOM ausgeführt. Wenn ein Skript unbedingt nach window.onload ausgeführt werden muss, kann die Erweiterung mit der Property document.readyState prüfen, ob onload bereits ausgelöst wurde.