说明
chrome.extensionTypes
API 包含 Chrome 扩展程序的类型声明。
类型
枚举
"author"
"user"
DeleteInjectionDetails
要移除的 CSS 的详细信息。必须设置代码或文件属性,但不能同时设置这两者。
属性
-
allFrames
布尔值 选填
如果 allFrames 为
true
,则表示应从当前网页的所有框架中移除该 CSS。默认情况下为false
,并且仅从顶部帧中移除。如果设置了true
和frameId
,则代码将从选定帧及其所有子帧中移除。 -
验证码
字符串(可选)
要移除的 CSS 代码。
-
cssOrigin
CSSOrigin 可选
要移除的 CSS 的 origin。默认设置为
"author"
。 -
文件
字符串(可选)
要移除的 CSS 文件。
-
frameId
数字可选
应从中移除 CSS 的框架。默认设置为 0(顶级帧)。
-
matchAboutBlank
布尔值 选填
如果 matchAboutBlank 为 true,则还会从 about:blank 和 about:srcdoc 框架中移除此代码(如果你的扩展程序有权访问其父文档的话)。默认为
false
。
DocumentLifecycle
帧的文档生命周期。
枚举
"cached"
"pending_deletion"
ExecutionWorld
用于执行脚本的 JavaScript 环境。可以是此扩展程序所独有的孤立世界、与网页的 JavaScript 共享的 DOM 主世界,也可以是只可用于通过 User Scripts API 注册的脚本的用户脚本世界。
枚举
FrameType
帧的类型。
枚举
"outermost_frame"
"fenced_frame"
"sub_frame"
ImageDetails
有关图片格式和质量的详细信息。
属性
-
格式
ImageFormat 选填
生成的图片的格式。默认值为
"jpeg"
。 -
quality
数字可选
当格式为
"jpeg"
时,用于控制所生成图片的质量。对于 PNG 图片,系统会忽略此值。随着画质的降低,生成的图片将具有更多的视觉伪影,存储该图片所需的字节数也会减少。
ImageFormat
图片的格式。
枚举
"png"
InjectDetails
要注入的脚本或 CSS 的详细信息。必须设置代码或文件属性,但不能同时设置这两者。
属性
-
allFrames
布尔值 选填
如果 allFrames 为
true
,则表示应将 JavaScript 或 CSS 注入当前网页的所有帧。默认情况下,它是false
并且仅注入到顶部框架。如果设置了true
和frameId
,则代码会插入所选帧及其所有子帧。 -
验证码
字符串(可选)
要注入的 JavaScript 或 CSS 代码。
警告:请谨慎使用
code
参数。如果使用不当,可能会导致您的扩展程序遭受跨站脚本攻击 -
cssOrigin
CSSOrigin 可选
Chrome 66 及更高版本要注入的 CSS 的 origin。只能为 CSS 指定此值,不能为 JavaScript 指定。默认设置为
"author"
。 -
文件
字符串(可选)
要注入的 JavaScript 或 CSS 文件。
-
frameId
数字可选
Chrome 50 及更高版本应注入脚本或 CSS 的框架。默认设置为 0(顶级帧)。
-
matchAboutBlank
布尔值 选填
如果 matchAboutBlank 为 true,那么如果您的扩展程序有权访问其父文档,则代码还会注入 about:blank 和 about:srcdoc 框架中。无法在顶层 about:-frames 中插入代码。默认为
false
。 -
runAt
RunAt 可选
JavaScript 或 CSS 将尽快注入到标签页中。默认值为“document_idle”。
RunAt
JavaScript 或 CSS 将尽快注入到标签页中。
枚举
"document_start"
在 css 中的任何文件之后、构建任何其他 DOM 或运行任何其他脚本之前注入脚本。
"document_end"
在 DOM 完成之后,在图片和框架等子资源加载之前立即注入脚本。
"document_idle"
浏览器会选择一个时间,在“document_end”之间以及 window.onload
事件触发后立即注入脚本。注入的确切时刻取决于文档的复杂程度和加载用时,并针对网页加载速度进行了优化。在“document_idle”运行的内容脚本不需要监听 window.onload
事件;它们一定会在 DOM 完成后运行。如果脚本确实需要在 window.onload
之后运行,该扩展程序可以使用 document.readyState
属性检查 onload
是否已触发。