scripting.RegisteredContentScript

类型

此类型的值是对象。它们包含以下属性：

allFrames 可选

boolean。如果指定为 true，则脚本将注入到所有 frame 中，即使该 frame 不是标签页中的最顶层 frame。每个 frame 都将独立检查 URL 要求；如果 URL 要求不满足，则不会注入到子 frame 中。默认为 false，表示只匹配顶层 frame。

css 可选

array of string。要注入到匹配页面的 CSS 文件列表。这些文件将按照在此数组中出现的顺序注入。

cssOrigin 可选

string。注入的样式来源，可以是 "user"，将 CSS 添加为用户样式表，或 "author"，将其添加为作者样式表。默认为 "author"。在 Firefox 和 Safari 中，此属性不区分大小写。

excludeMatches 可选

array of string。内容脚本被排除在外的页面列表，但否则会被注入其中。

id

string。内容脚本的 ID，在 API 调用中指定。

js 可选

array of string。扩展包中 JavaScript 文件的路径数组，用于注入到匹配页面。脚本将按照在此数组中出现的顺序注入。

matches 可选

array of string。内容脚本注入到的页面数组。必须为 scripting.registerContentScripts() 指定。

matchOriginAsFallback 可选

boolean。当 about:、data: 和 blob: 页面的源与 matches 中的模式匹配时，是否将代码注入这些页面，即使文档源是匿名的（由于使用了 CSP 或 iframe sandbox）。matches 中的匹配模式必须指定一个通配符路径 glob。默认为 false。

persistAcrossSessions 可选

boolean。指定此内容脚本是否跨浏览器重启和更新以及扩展重启持久化。默认为 true。

注意： 当扩展更新时，内容脚本会被清除。要恢复脚本，请在扩展的 runtime.onInstalled 事件处理程序中添加代码，以响应 "update" 原因。

runAt 可选

extensionTypes.RunAt。指定 JavaScript 文件何时注入到网页中。默认值为 document_idle。在 Firefox 中，runAt 也会影响 CSS 的插入点。在 Chrome 中，runAt 不影响 CSS 的插入点。

world 可选

scripting.ExecutionWorld。脚本执行的环境。默认值为 ISOLATED。

浏览器兼容性