跳转到主内容

User Scripts API

信息

这篇文章是关于 AdGuard 浏览器扩展,它只能保护用户的浏览器。要全面保护设备,请下载 AdGuard 应用程序

当添加自定义过滤器或用户规则时,会出现一个通知,询问您是否启用开发者模式以在扩展中使用这些功能。

Notification *border

从 5.2 版本开始,AdGuard 浏览器扩展开始使用 User Scripts API。 Chrome 要求使用这一新 API,以遵循用户安全的最佳实践。

什么是 User Scripts API?​

User Scripts API 是一种工具,允许扩展程序在网页上运行自定义的 JavaScript 脚本。此类脚本通常用于以网站原生方式之外的手段修改或增强网页功能。

随着 Chrome 转向 Manifest V3,许多旧有的脚本注入方式受到了限制或延迟。不过,User Scripts API 是个例外。

更多关于 MV3 政策影响的信息,请参阅我们的博客文章。

如何启用开发者模式​

要在「用户规则」标签页中使用自定义过滤器和 JavaScript 规则,您必须先设置好浏览器。这将为扩展程序提供一种可靠且安全的方法,在最佳时机将脚本注入网页。请根据您的 Chrome 版本,按照以下说明进行操作。

对于 138 版本之前的 Chrome​

您必须为扩展启用开发者模式。为此,请点击右上角的三个点以打开 Chrome 菜单,前往「扩展」 ⭢ 「管理扩展」,然后切换「开发者模式」开关。

管理扩展程序 *border

适用于 Chrome 138 及更高版本​

您必须启用「允许运行用户脚本」开关。要执行此操作,请点击右上角的三个点打开 Chrome 菜单,进入「扩展」 ⭢ 「管理扩展」,找到 AdGuard 浏览器扩展的「详细信息」,然后切换「允许用户脚本」开关。

管理扩展程序 *border