# @ghostery/adblocker-webextension 中文文档

规范地址：https://npmcn.com/package/%40ghostery/adblocker-webextension/

版本：2\.20\.3
npm 元数据更新时间：2026-10-28T13:04:47.881Z
中文译文更新时间：2026-11-16T07:57:41.930Z
软件包许可：MPL-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ghostery/adblocker-webextension
原文对照：https://npmcn.com/package/%40ghostery/adblocker-webextension/?lang=original
项目主页：https://github.com/ghostery/adblocker#readme
源码仓库：https://github.com/ghostery/adblocker

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：162 kB，15 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2024-10-17T10:41:41.189Z
- 最新版本发布：2026-10-28T13:04:47.278Z
- 近 30 天下载量：3098（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：65（近 12 个月 24 个）

## 中文简介

Ghostery 屏蔽器 WebExtension 包装器

## 安装

```sh
npm install @ghostery/adblocker-webextension
```

也可以使用：`pnpm add @ghostery/adblocker-webextension`、`yarn add @ghostery/adblocker-webextension`、`bun add @ghostery/adblocker-webextension`

## README

# Web 扩展障碍器

_高效 最小值 \* Java脚本 类型脚本 uBlock 来源和易列表兼容_  
_[节点.js](https://github.com/ghostery/adblocker/tree/master/packages/adblocker) • 妇女 [傀儡](https://github.com/ghostery/adblocker/tree/master/packages/adblocker-puppeteer) • 妇女 [电子](https://github.com/ghostery/adblocker/tree/master/packages/adblocker-electron) • 妇女 [网络扩展](https://github.com/ghostery/adblocker/tree/master/packages/adblocker-webextension)_

[![Github Actions Build Status](https://img.shields.io/github/actions/workflow/status/ghostery/adblocker/tests.yml?label=tests&style=flat-square)](https://github.com/ghostery/adblocker/actions?query=workflow%3ATests) [![Github Actions Assets Status](https://img.shields.io/github/actions/workflow/status/ghostery/adblocker/assets.yml?label=assets&style=flat-square)](https://github.com/ghostery/adblocker/actions?query=workflow%3Assets) [![Blazing Fast](https://img.shields.io/badge/speed-blazing%20%F0%9F%94%A5-brightgreen.svg?style=flat-square)](https://twitter.com/acdlite/status/974390255393505280) [![npm version](https://img.shields.io/npm/v/@ghostery/adblocker.svg?style=flat-square)](https://www.npmjs.com/package/@ghostery/adblocker) [![weekly downloads from npm](https://img.shields.io/npm/dw/@ghostery/adblocker.svg?style=flat-square)](https://www.npmjs.com/package/@ghostery/adblocker)  
[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://npmcn.com/package/%40ghostery/adblocker-webextension/#readme-badge) [![Follow Ghostery on Twitter](https://img.shields.io/twitter/follow/ghostery.svg?label=follow+ghostery&style=flat-square)](https://twitter.com/ghostery) [![Dependabot](https://img.shields.io/badge/dependabot-enabled-brightgreen?logo=dependabot&style=flat-square)](https://github.com/ghostery/adblocker) [![License Badge](https://img.shields.io/github/license/ghostery/adblocker?style=flat-square)](https://github.com/ghostery/adblocker/blob/master/LICENSE) [![LGTM Badge](https://img.shields.io/lgtm/alerts/github/ghostery/adblocker?style=flat-square)](https://lgtm.com/projects/g/ghostery/adblocker?mode=list)

* * *

## 开始

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

## 使用量

对a _完整实例_ 离职 : [@ghostery/adblocker-web扩展-例](https://github.com/ghostery/adblocker/tree/master/packages/adblocker-webextension-example)。 。 。 .

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

从 _背景页面_ 您的扩展名 :

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

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

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

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

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

你准备好屏蔽广告了!

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

如果您已经本地过滤器 :

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

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

从 URL 获取列表 :

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

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

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

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

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

### 阻断扩展名中

停止屏蔽广告:

```javascript
blocker.disableBlockingInBrowser();
```

### 使用序列化的缓存块

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

```javascript
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 是什么？

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 和提交记录判断。

