userScripts.RegisteredUserScript

Typ

Werte dieses Typs sind ein Objekt, das folgende Eigenschaften enthält:

allFrames Optional

boolean. Wenn allFrames true ist, wird das Skript in alle Frames einer Seite injiziert. Standardmäßig ist es false und das Skript wird nur in den obersten Frame injiziert.

id

string. Die ID eines Nutzer-Skripts. Diese Eigenschaft darf nicht mit einem '_' beginnen, da dies als Präfix für generierte Skript-IDs reserviert ist.

js Optional für userScripts.update() Aufrufe, erforderlich für userScripts.register()

array von userScripts.ScriptSource. Die Skripte, die in passende Seiten injiziert werden sollen.

matches Optional

array von string. Übereinstimmungsmuster für die Seiten, in denen das Skript ausgeführt werden soll. matches oder includeGlobs müssen in userScripts.register() Aufrufen angegeben werden.

excludeMatches Optional

array von string. Übereinstimmungsmuster für Seiten, in denen das Skript nicht ausgeführt werden soll.

includeGlobs Optional

string. Glob-Muster für die Seiten, in denen das Skript ausgeführt werden soll. matches oder includeGlobs müssen in userScripts.register() Aufrufen angegeben werden.

excludeGlobs Optional

string. Glob-Muster für Seiten, in denen das Skript nicht ausgeführt werden soll.

runAt Optional

extensionTypes.RunAt. Der früheste Zeitpunkt, zu dem das Skript in einen Tab injiziert wird. Standardmäßig "document_idle".

world Optional

userScripts.ExecutionWorld. Die Ausführungsumgebung, die zum Ausführen der Skripte verwendet wird. Standardmäßig "USER_SCRIPT".

worldId Optional

string. ID einer Nutzer-Skriptwelt, in der das Skript ausgeführt wird. Nur gültig, wenn world USER_SCRIPT ist oder nicht angegeben wurde. Wenn worldId nicht angegeben wird, wird das Skript in der Standard-USER_SCRIPT-Welt ("") ausgeführt. Werte mit führendem Unterstrich (_) sind reserviert. Die maximale Länge beträgt 256 Zeichen. Eine Welt kann von mehreren Skripten als ihre Ausführungsumgebung verwendet werden. Um das Verhalten einer Welt zu konfigurieren, geben Sie ihre worldId an userScripts.configureWorld weiter, bevor das erste Skript in dieser Welt ausgeführt wird.

Browser-Kompatibilität