UserScripts.UserScriptOptions (旧版)

警告:这是已弃用的 userScripts API 的文档。它在 Manifest V2 的 Firefox 中可用。有关在 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 开始的 URL,指向要注册的 JavaScript 文件),或者一个名为 code 的属性(该属性是要注册的一些 JavaScript 代码)。

matchAboutBlank 可选

content_scripts 键中的 match_about_blank 相同。

matches

content_scripts 键中的 matches 相同。

runAt 可选

content_scripts 键中的 run_at 相同。

scriptMetadata 可选

用户脚本元数据值。

它具有与 browser.contentScripts.register 支持的 contentScript 选项类似的语法。