scripting.RegisteredContentScript

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

类型

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

allFrames 可选

布尔值。如果指定为 true,则脚本将注入到所有框架中,即使框架不是选项卡中最顶层的框架。每个框架都会独立检查 URL 要求;如果未满足 URL 要求,则不会注入到子框架中。默认为 false,这意味着仅匹配顶层框架。

css 可选

字符串数组。要注入到匹配页面中的 CSS 文件列表。这些文件按其在此数组中出现的顺序注入。

excludeMatches 可选

字符串数组。此内容脚本从中排除但否则会注入到的页面的数组。

id

字符串。内容脚本的 ID,在 API 调用中指定。

js 可选

字符串数组。扩展包中要注入到匹配页面的 JavaScript 文件的路径数组。脚本按其在此数组中出现的顺序注入。

matches 可选

字符串数组。此内容脚本注入到的页面的数组。必须为 scripting.registerContentScripts() 指定。

matchOriginAsFallback 可选

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

persistAcrossSessions 可选

布尔值。指定此内容脚本是否在浏览器重新启动和更新以及扩展重新启动时保持不变。默认为 true

runAt 可选

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

world 可选

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

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

注意:此 API 基于 Chromium 的 chrome.scripting API。