contentScripts

使用此 API 注册 content script。注册 content script 会指示浏览器将指定的 content script 插入到与给定 URL 模式匹配的页面中。

注意:在使用 Manifest V3 或更高版本时,请使用 scripting.registerContentScripts() 来注册脚本。

此 API 与 "content_scripts" manifest.json 键非常相似,不同之处在于,使用 "content_scripts" 时,content script 集及其关联模式在安装时是固定的。而使用 contentScripts API 时,扩展可以在运行时注册和注销脚本。

要使用此 API,请调用 contentScripts.register(),并传入一个定义要注册的脚本、URL 模式和其他选项的对象。此调用会返回一个 Promise,该 Promise 会解析为一个 contentScripts.RegisteredContentScript 对象。

RegisteredContentScript 对象代表在 register() 调用中注册的脚本。它定义了一个 unregister() 方法,您可以使用它来注销 content script。content script 在创建它们的页面被销毁时也会被自动注销。例如,如果它们是从背景页面注册的,则在背景页面被销毁时会自动注销;如果它们是从侧边栏或弹出窗口注册的,则在侧边栏或弹出窗口关闭时会自动注销。

没有 contentScripts API 权限,但扩展必须为其传递给 register() 的任何模式拥有相应的 host 权限

类型

contentScripts.RegisteredContentScript

此类型的对象由 contentScripts.register() 函数返回。它代表该调用注册的 content script,并可用于注销 content script。

函数

contentScripts.register()

注册给定的 content script。

扩展程序示例

浏览器兼容性