userScripts.RegisteredUserScript

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

allFrames Optional

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

id

string. Die ID eines Benutzer-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 übereinstimmende Seiten injiziert werden sollen.

matches Optional

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

excludeMatches Optional

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

includeGlobs Optional

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

excludeGlobs Optional

string. Glob-Muster für Seiten, auf 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. Standardwert ist "document_idle".

world Optional

userScripts.ExecutionWorld. Die Ausführungsumgebung, die verwendet werden soll, um die Skripte auszuführen. Standard ist "USER_SCRIPT".

worldId Optional

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