scripting.RegisteredContentScript

该对象包含要注册或已注册的脚本的详细信息。

类型

该类型的取值为对象。它包含以下属性:

allFrames 可选

boolean。若设置为 true,则该脚本将被注入到所有框架中(即便该框架不是标签页中最顶层的框架)。各框架将相互独立地检查 URL 要求;如果不满足 URL 要求,则不会注入到子框架中。默认设为 false,即只会匹配最顶层的框架。

css 可选

string 数组(array)。要注入到匹配页面的 CSS 文件列表。将按照数组中的顺序注入。

excludeMatches 可选

string 数组(array)。此内容脚本排除而不注入的页面列表。

id

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

js 可选

string 数组(array)。要注入到匹配页面的扩展包中的 JavaScript 文件的路径。将按照数组中的顺序注入脚本。

matches 可选

string 数组(array)。内容脚本将要注入的页面。必须在 scripting.registerContentScripts() 中指定。

matchOriginAsFallback 可选

boolean。当页面的来源与 matches 中的模式匹配时,是否将代码注入到 about:data:blob: 页面中,即使文档来源是不透明的(由于 CSP 或 iframe 沙箱)。matches 中的匹配模式必须指定通配符路径 glob。默认为 false

persistAcrossSessions 可选

boolean。指定此内容脚本是否在浏览器重新启动和更新以及扩展重新启动时保留。默认为 true

runAt 可选

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

world 可选

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

浏览器兼容性

BCD tables only load in the browser

备注: 该 API 基于 Chromium 的 chrome.scripting API。