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。