UserScripts.UserScriptOptions(旧版)
警告:
本文档针对旧版 userScripts API 编写,适用于 Firefox Manifest V2 版本。如希望在 Manifest V3 中使用用户脚本功能,可参见新的 userScripts API。
UserScriptOptions 对象表示要注册的内容脚本。它具有与 browser.contentScripts.register 支持的 contentScript 选项类似的语法。不同之处在于:
- 它不支持 CSS 属性(使用 browser.contentScripts.register 动态注册/注销样式表)
- 它支持一个可选的 scriptMetadata 属性(作为一个普通的 JSON 对象,其中包含与注册的 userScripts 关联的一些元数据属性)
UserScriptOptions 对象具有以下属性:
allFrames可选-
与
content_scripts键中的all_frames相同。 excludeGlobs可选-
与
content_scripts键中的exclude_globs相同。 excludeMatches可选-
与
content_scripts键中的exclude_matches相同。 includeGlobs可选-
与
content_scripts键中的include_globs相同。 js可选-
一个对象数组。每个对象都有一个名为
file且值为一个从扩展的 manifest.json 开始指向要注册的 JavaScript 文件的 URL 的属性,或者是一个名为code且包含要注册的一些 JavaScript 代码的属性。 matchAboutBlank可选-
与
content_scripts键中的match_about_blank相同。 matches-
与
content_scripts键中的matches相同。 runAt可选-
与
content_scripts键中的run_at相同。 scriptMetadata可选-
一个用户脚本元数据值
它具有与 browser.contentScripts.register 支持的 contentScript 选项类似的语法。