内容脚本

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

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

此 API 与"content_scripts" manifest.json 密钥非常相似,区别在于使用 "content_scripts" 时,内容脚本集和关联模式在安装时是固定的。使用 contentScripts API,扩展程序可以在运行时注册和注销脚本。

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

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

没有 contentScripts API 权限,但扩展程序必须具有与其传递给 register() 的任何模式相关的适当主机权限

类型

contentScripts.RegisteredContentScript

此类型的对象由contentScripts.register() 函数返回。它表示通过该调用注册的内容脚本,可用于注销内容脚本。

函数

contentScripts.register()

注册给定的内容脚本。

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

示例扩展