@ghostery/adblocker-playwright

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

幽灵附身者 Playwright 包装器

中文使用文档
文档目录4 节
  1. 开始
  2. 使用量
  3. 禁用页块
  4. 使用序列化的缓存块

游戏作家障碍器

高效 最小值 * 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-playwright。 。 。 .

使用量

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

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

import * as pw from 'playwright';
import { PlaywrightBlocker } from '@ghostery/adblocker-playwright';
import fetch from 'cross-fetch'; // required 'fetch'

const browser = await pw.firefox.launch({ headless: false });
const page = await browser.newPage();

PlaywrightBlocker.fromPrebuiltAdsAndTracking(fetch).then((blocker) => {
  blocker.enableBlockingInPage(page);
});

你准备好屏蔽广告了!

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

如果您已经本地过滤器 :

import { PlaywrightBlocker } from '@ghostery/adblocker-playwright';

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

从 URL 获取列表 :

import { PlaywrightBlocker } from '@ghostery/adblocker-playwright';
import fetch from 'cross-fetch'; // required 'fetch'

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

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

import { PlaywrightBlocker } from '@ghostery/adblocker-playwright';
import fetch from 'cross-fetch'; // required 'fetch'

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

禁用页块

要停止屏蔽页面中的广告:

await blocker.disableBlockingInPage(page);

使用序列化的缓存块

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

import * as pw from 'playwright';
import { PlaywrightBlocker } from '@ghostery/adblocker-playwright';
import fetch from 'cross-fetch'; // required 'fetch'
import { promises as fs } from 'fs'; // used for caching

const browser = await pw.firefox.launch({ headless: false });
const page = await browser.newPage();

PlaywrightBlocker.fromPrebuiltAdsAndTracking(fetch, {
  path: 'engine.bin',
  read: fs.readFile,
  write: fs.writeFile,
}).then((blocker) => {
  blocker.enableBlockingInPage(page);
});

或者你可以用手动控制缓存的方式:

import { PlaywrightBlocker } from '@ghostery/adblocker-playwright';
import fetch from 'cross-fetch'; // required 'fetch'

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

版本与发布记录

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

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

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

@ghostery/adblocker-playwright 是什么?

幽灵附身者 Playwright 包装器

如何安装 @ghostery/adblocker-playwright?

在项目目录运行 npm install @ghostery/adblocker-playwright,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:playwright(^1.x)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@ghostery/adblocker-playwright 支持 TypeScript 吗?

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

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

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

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

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

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

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

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

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