scripting.RegisteredContentScript

Werte dieses Typs sind Objekte. Sie enthalten folgende Eigenschaften:

allFrames Optional

boolean. Wenn auf true gesetzt, wird das Skript in alle Frames eingefügt, auch wenn der Frame nicht der oberste Frame im Tab ist. Jeder Frame wird unabhängig auf URL-Anforderungen geprüft; es wird nicht in untergeordnete Frames eingefügt, wenn die URL-Anforderungen nicht erfüllt sind. Standardmäßig auf false gesetzt, was bedeutet, dass nur der oberste Frame berücksichtigt wird.

css Optional

array von string. Die Liste der CSS-Dateien, die in passende Seiten eingefügt werden sollen. Diese werden in der Reihenfolge eingefügt, in der sie in diesem Array erscheinen.

excludeMatches Optional

array von string. Array von Seiten, von denen dieses Inhaltsskript ausgeschlossen ist, in die es sonst eingefügt würde.

id

string. Die ID des Inhaltsskripts, die im API-Aufruf angegeben wird.

js Optional

array von string. Array von Pfaden zu JavaScript-Dateien im Erweiterungspaket, die in passende Seiten eingefügt werden sollen. Skripte werden in der Reihenfolge eingefügt, in der sie in diesem Array erscheinen.

matches Optional

array von string. Array der Seiten, in die dieses Inhaltsskript eingefügt wird. Muss für scripting.registerContentScripts() angegeben werden.

matchOriginAsFallback Optional

boolean. Ob Code in about:, data: und blob: Seiten eingefügt wird, wenn deren Ursprung dem Muster in matches entspricht, auch wenn der Dokumentenursprung nicht sichtbar ist (aufgrund der Verwendung von CSP oder iframe sandbox). Matchmuster in matches müssen ein Wildcard-Pfad-Glob angeben. Standardmäßig auf false gesetzt.

persistAcrossSessions Optional

boolean. Gibt an, ob dieses Inhaltsskript über Browser-Neustarts, Updates und Erweiterungs-Neustarts hinweg bestehen bleibt. Standardmäßig auf true gesetzt.

Hinweis: Wenn eine Erweiterung aktualisiert wird, werden Inhaltsskripte gelöscht. Um Skripte wiederherzustellen, fügen Sie Code in den runtime.onInstalled Ereignishandler der Erweiterung hinzu, der auf den Grund "update" reagiert.

runAt Optional

extensionTypes.RunAt. Gibt an, wann JavaScript-Dateien in die Webseite eingefügt werden. Der Standardwert ist document_idle. In Firefox beeinflusst runAt auch den Punkt, an dem das CSS eingefügt wird. In Chrome beeinflusst runAt nicht den Punkt der CSS-Einfügung.

world Optional

scripting.ExecutionWorld. Die Ausführungsumgebung, in der ein Skript ausgeführt wird. Der Standardwert ist ISOLATED.