scripting.RegisteredContentScript
Dieses Objekt enthält Details zu einem Skript, das registriert werden soll oder bereits registriert ist.
Typ
Werte dieses Typs sind Objekte. Sie enthalten folgende Eigenschaften:
allFrames
Optional-
boolean
. Wenn auftrue
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 überprüft; es wird nicht in untergeordnete Frames eingefügt, wenn die URL-Anforderungen nicht erfüllt sind. Standardmäßigfalse
, was bedeutet, dass nur der obere Frame berücksichtigt wird. css
Optional-
array
vonstring
. 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. cssOrigin
Optional-
string
. Der Stil-Ursprung für die Injektion, entweder"user"
, um das CSS als Benutzer-Stile einzufügen, oder"author"
, um es als Autor-Stile einzufügen. Standardmäßig"author"
. Diese Eigenschaft ist in Firefox und Safari nicht case-sensitiv. excludeMatches
Optional-
array
vonstring
. Array von Seiten, von denen dieses Inhaltskript ausgeschlossen ist, in die es ansonsten eingefügt würde. id
-
string
. Die ID des Inhaltskripts, die im API-Aufruf angegeben wurde. js
Optional-
array
vonstring
. Array der Pfade 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
vonstring
. Array der Seiten, in die dieses Inhaltskript eingefügt wird. Muss fürscripting.registerContentScripts()
angegeben werden. matchOriginAsFallback
Optional-
boolean
. Gibt an, ob Code aufabout:
,data:
undblob:
Seiten eingefügt wird, wenn ihr Ursprung dem Muster inmatches
entspricht, auch wenn der Dokumenten-Ursprung undurchsichtig ist (aufgrund der Verwendung von CSP oder iframe-Sandbox). Die Match-Muster inmatches
müssen ein Wildcard-Pfad-Glob angeben. Standardmäßigfalse
. persistAcrossSessions
Optional-
boolean
. Gibt an, ob dieses Inhaltskript über Browserneustarts und Updates sowie Erweiterungsneustarts hinweg bestehen bleibt. Standardmäßigtrue
.Hinweis: Wenn eine Erweiterung aktualisiert wird, werden Inhaltskripte gelöscht. Um Skripte wiederherzustellen, fügen Sie Code zum
runtime.onInstalled
Ereignishandler der Erweiterung hinzu, der auf den Grund"update"
reagiert. runAt
Optional-
extensionTypes.RunAt
. Gibt an, wann die JavaScript-Dateien in die Webseite eingefügt werden. Der Standardwert istdocument_idle
. In Firefox beeinflusstrunAt
auch den Punkt, an dem das CSS eingefügt wird. In Chrome beeinflusstrunAt
nicht den Einfügepunkt des CSS. world
Optional-
scripting.ExecutionWorld
. Die Ausführungsumgebung, in der ein Skript ausgeführt wird. Der Standardwert istISOLATED
.
Browser-Kompatibilität
Loading…
Hinweis:
Diese API basiert auf Chromium's chrome.scripting
API.