chrome.extensionTypes

说明

chrome.extensionTypes API 包含 Chrome 扩展程序的类型声明。

类型

CSSOrigin

Chrome 66 及更高版本

所注入 CSS 的 origin

枚举

"author"

"user"

DeleteInjectionDetails

Chrome 87 及更高版本

要移除的 CSS 的详细信息。必须设置代码或文件属性,但不能同时设置这两者。

属性

  • allFrames

    布尔值 选填

    如果 allFrames 为 true,则表示应从当前网页的所有框架中移除该 CSS。默认情况下为 false,并且仅从顶部帧中移除。如果设置了 trueframeId,则代码将从选定帧及其所有子帧中移除。

  • 验证码

    字符串(可选)

    要移除的 CSS 代码。

  • cssOrigin

    CSSOrigin 可选

    要移除的 CSS 的 origin。默认设置为 "author"

  • 文件

    字符串(可选)

    要移除的 CSS 文件。

  • frameId

    数字可选

    应从中移除 CSS 的框架。默认设置为 0(顶级帧)。

  • matchAboutBlank

    布尔值 选填

    如果 matchAboutBlank 为 true,则还会从 about:blank 和 about:srcdoc 框架中移除此代码(如果你的扩展程序有权访问其父文档的话)。默认为 false

DocumentLifecycle

Chrome 106 及更高版本

帧的文档生命周期。

枚举

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 及更高版本

用于执行脚本的 JavaScript 环境。可以是此扩展程序所独有的孤立世界、与网页的 JavaScript 共享的 DOM 主世界,也可以是只可用于通过 User Scripts API 注册的脚本的用户脚本世界。

枚举

FrameType

Chrome 106 及更高版本

帧的类型。

枚举

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDetails

有关图片格式和质量的详细信息。

属性

  • 格式

    ImageFormat 选填

    生成的图片的格式。默认值为 "jpeg"

  • quality

    数字可选

    当格式为 "jpeg" 时,用于控制所生成图片的质量。对于 PNG 图片,系统会忽略此值。随着画质的降低,生成的图片将具有更多的视觉伪影,存储该图片所需的字节数也会减少。

ImageFormat

Chrome 44 及更高版本

图片的格式。

枚举

"png"

InjectDetails

要注入的脚本或 CSS 的详细信息。必须设置代码或文件属性,但不能同时设置这两者。

属性

  • allFrames

    布尔值 选填

    如果 allFrames 为 true,则表示应将 JavaScript 或 CSS 注入当前网页的所有帧。默认情况下,它是 false 并且仅注入到顶部框架。如果设置了 trueframeId,则代码会插入所选帧及其所有子帧。

  • 验证码

    字符串(可选)

    要注入的 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

Chrome 44 及更高版本

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 是否已触发。