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。