@ghostery/adblocker-webextension

中文文档
2.20.3发布于 2026/10/28MPL-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 3098

Ghostery 屏蔽器 WebExtension 包装器

中文使用文档
文档目录4 节
  1. 开始
  2. 使用量
  3. 阻断扩展名中
  4. 使用序列化的缓存块

Web 扩展障碍器

高效 最小值 * Java脚本 类型脚本 uBlock 来源和易列表兼容
节点.js • 妇女 傀儡 • 妇女 电子 • 妇女 网络扩展

Github Actions Build Status Github Actions Assets Status Blazing Fast npm version weekly downloads from npm
code style: prettier Follow Ghostery on Twitter Dependabot License Badge LGTM Badge


开始

安装 : npm install --save @ghostery/adblocker-webextension。 。 。 .

使用量

对a 完整实例 离职 : @ghostery/adblocker-web扩展-例。 。 。 .

创建实例 WebExtensionBlocker 开始屏蔽广告!

从 背景页面 您的扩展名 :

import { WebExtensionBlocker } from '@ghostery/adblocker-webextension';

WebExtensionBlocker.fromPrebuiltAdsAndTracking().then((blocker) => {
  blocker.enableBlockingInBrowser(browser);
});

在基于铬的浏览器上,您需要多填充, 如 webextension-polyfill 使这个工作:

import { browser } from 'webextension-polyfill';
import { WebExtensionBlocker } from '@ghostery/adblocker-webextension';

WebExtensionBlocker.fromPrebuiltAdsAndTracking().then((blocker) => {
  blocker.enableBlockingInBrowser(browser);
});

你准备好屏蔽广告了!

还有别的办法 创建屏蔽引擎实例 改为 开始屏蔽广告.

如果您已经本地过滤器 :

import { WebExtensionBlocker } from '@ghostery/adblocker-webextension';

const blocker = WebExtensionBlocker.parse(fs.readFileSync('easylist.txt', 'utf-8'));

从 URL 获取列表 :

import { WebExtensionBlocker } from '@ghostery/adblocker-webextension';

const blocker = await WebExtensionBlocker.fromLists(fetch, [
  'https://easylist.to/easylist/easylist.txt'
]);

使用现成配置来屏蔽广告和可选的跟踪器:

import { WebExtensionBlocker } from '@ghostery/adblocker-webextension';

let blocker = await WebExtensionBlocker.fromPrebuiltAdsOnly(); // ads only
blocker = await WebExtensionBlocker.fromPrebuiltAdsAndTracking(); // ads and tracking

阻断扩展名中

停止屏蔽广告:

blocker.disableBlockingInBrowser();

使用序列化的缓存块

避免造成同样的情况: WebExtensionBlocker 再来一遍, 您可以将其序列化为字节阵列, 您可以在磁盘上更快存储 装入.

import { WebExtensionBlocker } from '@ghostery/adblocker-webextension';

WebExtensionBlocker.fromPrebuiltAdsAndTracking().then((blocker) => {
  const buffer = blocker.serialize();
  const restoredBlocker = WebExtensionBlocker.deserialize(buffer);
  // `restoredBlocker` is deep-equal to `blocker`!
});

版本与发布记录

@ghostery/adblocker-webextension 共发布 65 个版本,首次发布于 2024/10/17;过去 12 个月发布了 24 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.20.3latest2026/10/2818 天前
2.20.22026/10/2818 天前
2.20.12026/10/101 个月前
2.20.02026/10/101 个月前
2.18.22026/08/053 个月前
2.18.12026/07/014 个月前

关于 @ghostery/adblocker-webextension 的常见问题

@ghostery/adblocker-webextension 是什么?

Ghostery 屏蔽器 WebExtension 包装器

如何安装 @ghostery/adblocker-webextension?

在项目目录运行 npm install @ghostery/adblocker-webextension,或使用 pnpm add / yarn add / bun add。

@ghostery/adblocker-webextension 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@ghostery/adblocker-webextension 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@ghostery/adblocker-webextension 可以商用吗?

@ghostery/adblocker-webextension 使用 MPL-2.0 许可。弱 Copyleft:可以商用,也可以和闭源代码一起使用;但如果分发时修改了 MPL 授权的文件,这些文件的修改需以 MPL 开源。以上为概括,不构成法律意见,请以许可原文为准。

@ghostery/adblocker-webextension 的下载量有多少?

根据 npm 官方下载统计,@ghostery/adblocker-webextension 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,098 次,日均约 103 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ghostery/adblocker-webextension 还在维护吗?

最新版本 2.20.3 发布于 2026/10/28(18 天前);至今共发布 65 个版本,其中过去 12 个月发布了 24 个;首次发布于 2024/10/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。