chrome.extensionTypes

Beschreibung

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

Typen

CSSOrigin

Chrome 66 und höher

Der origin-Code der eingefügten CSS.

Enum

DeleteInjectionDetails

Chrome 87 oder höher

Details zum zu entfernenden Preisvergleichsportal. Es muss entweder der Code oder die Dateieigenschaft festgelegt werden, aber beides kann nicht gleichzeitig festgelegt werden.

Attribute

  • allFrames

    Boolescher Wert optional

    Wenn allFrames den Wert true hat, bedeutet dies, dass das CSS aus allen Frames der aktuellen Seite entfernt werden sollte. Standardmäßig ist er 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 origin des zu entfernenden CSS-Codes. Die Standardeinstellung ist "author".

  • Datei

    String optional

    Zu entfernende CSS-Datei

  • frameId

    Nummer optional

    Der Frame, aus dem das CSS entfernt werden soll. Die Standardeinstellung ist 0, d. h. der Frame auf oberster Ebene.

  • matchAboutBlank

    Boolescher Wert optional

    Wenn „matchAboutBlank“ auf „true“ 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 oder höher

Der Dokumentlebenszyklus des Frames.

Enum

ExecutionWorld

Chrome 111 und höher

Die JavaScript-Welt, in der ein Skript ausgeführt werden kann. Dies kann entweder eine isolierte Welt sein, die nur für diese Erweiterung existiert, die Hauptwelt des DOM, die mit dem JavaScript der Seite geteilt wird, oder eine Nutzerskriptwelt, die nur für Skripts verfügbar ist, die über die User Scripts API registriert sind.

Enum

FrameType

Chrome 106 oder höher

Die Art des Frames.

Enum

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDetails

Details zum Format und zur Qualität eines Bildes.

Attribute

  • formatieren

    ImageFormat optional

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

  • quality

    Nummer optional

    Wenn das Format "jpeg" ist, steuert er die Qualität des Bilds. Dieser Wert wird bei PNG-Bildern ignoriert. Bei verminderter Qualität weist das resultierende Bild mehr visuelle Artefakte auf und die Anzahl der zum Speichern erforderlichen Bytes wird abnehmen.

ImageFormat

Chrome 44 und höher

Das Format eines Bildes.

Enum

"jpeg"

"png"

InjectDetails

Details zum zu injizierenden Skript oder CSS-Code. Es muss entweder der Code oder die Dateieigenschaft festgelegt werden, aber beides kann nicht gleichzeitig festgelegt werden.

Attribute

  • allFrames

    Boolescher Wert optional

    Wenn allFrames true ist, impliziert, dass JavaScript oder CSS in alle Frames der aktuellen Seite eingeschleust werden sollten. Standardmäßig lautet er false und wird nur in den obersten Frame eingeschleust. 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 eingeschleust werden soll.

    Warnung:Verwenden Sie den Parameter code mit Vorsicht. Bei falscher Verwendung kann deine Erweiterung für Cross-Site-Scripting-Angriffe geöffnet werden

  • cssOrigin

    CSSOrigin optional

    Chrome 66 und höher

    Der origin des einzuführenden CSS-Codes. Dieser kann nur für CSS angegeben werden, nicht für JavaScript. Die Standardeinstellung ist "author".

  • Datei

    String optional

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

  • frameId

    Nummer optional

    Chrome 50 oder höher

    Frame, in den das Script oder der CSS-Code eingeschleust werden soll Die Standardeinstellung ist 0, d. h. der Frame auf oberster Ebene.

  • matchAboutBlank

    Boolescher Wert optional

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

  • runAt

    RunAt optional

    Das Datum, bis zu dem der JavaScript- oder CSS-Code frühestens in den Tab eingeschleust wird. Der Standardwert ist „document_idle“.

RunAt

Chrome 44 und höher

Das Datum, bis zu dem der JavaScript- oder CSS-Code frühestens in den Tab eingeschleust wird.

Enum

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

"document_end"
Das Skript wird direkt nach Abschluss des DOM eingeschleust, aber bevor Unterressourcen 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 Ereignisses window.onload aus. Der genaue Zeitpunkt der Einfügung hängt davon ab, wie komplex das Dokument ist und wie lange das Laden dauert. Der Zeitpunkt der Einfügung ist für die Seitenladegeschwindigkeit optimiert. Inhaltsscripts, die unter "document_idle" ausgeführt werden, müssen nicht auf das Ereignis window.onload warten. Sie werden auf jeden Fall nach Abschluss des DOMs ausgeführt. Wenn ein Script definitiv nach window.onload ausgeführt werden muss, kann die Erweiterung mithilfe der Eigenschaft document.readyState prüfen, ob onload bereits ausgelöst wurde.