UserScripts.UserScriptOptions (Legacy)
Warnung:
Dies ist die Dokumentation für die veraltete userScripts API. Sie ist in Firefox für Manifest V2 verfügbar. Für die Funktionalität der Benutzerskripte in Manifest V3 siehe die neue userScripts API.
Das UserScriptOptions-Objekt repräsentiert die Content-Skripte, die registriert werden sollen. Es hat eine ähnliche Syntax wie die contentScript-Optionen, die von browser.contentScripts.register unterstützt werden. Die Unterschiede sind:
- Es unterstützt keine CSS-Eigenschaft (verwenden Sie
browser.contentScripts.register, um Stylesheets dynamisch zu registrieren/abzumelden). - Es unterstützt eine optionale
scriptMetadata-Eigenschaft (als einfaches JSON-Objekt, das einige Metadaten-Eigenschaften enthält, die mit den registriertenuserScriptsverbunden sind).
Das UserScriptOptions-Objekt hat die folgenden Eigenschaften:
allFramesOptional-
Entspricht
all_framesimcontent_scripts-Schlüssel. excludeGlobsOptional-
Entspricht
exclude_globsimcontent_scripts-Schlüssel. excludeMatchesOptional-
Entspricht
exclude_matchesimcontent_scripts-Schlüssel. includeGlobsOptional-
Entspricht
include_globsimcontent_scripts-Schlüssel. jsOptional-
Ein Array von Objekten. Jedes Objekt hat entweder eine Eigenschaft namens
file, die eine URL ist, die beim Manifest.json der Erweiterung beginnt und auf eine zu registrierende JavaScript-Datei zeigt, oder eine Eigenschaft namenscode, die JavaScript-Code zur Registrierung ist. matchAboutBlankOptional-
Entspricht
match_about_blankimcontent_scripts-Schlüssel. matches-
Entspricht
matchesimcontent_scripts-Schlüssel. runAtOptional-
Entspricht
run_atimcontent_scripts-Schlüssel. scriptMetadataOptional-
Ein Metadatenwert für Benutzerskripte.
Es hat eine ähnliche Syntax wie die contentScript-Optionen, die von browser.contentScripts.register unterstützt werden.