# puppeteer-extra-plugin-adblocker

> A puppeteer-extra plugin to block ads and trackers.

Latest version **2.13.6** (published 2023-03-01) · MIT license · 0 weekly downloads

## Install

```sh
npm install puppeteer-extra-plugin-adblocker
pnpm add puppeteer-extra-plugin-adblocker
yarn add puppeteer-extra-plugin-adblocker
bun add puppeteer-extra-plugin-adblocker
```

## Health

**Score 30/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.13.6 |
| Published | 2023-03-01 |
| First published | 2019-11-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=8 |
| Dependencies | 4 |
| Unpacked size | 45.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 7397 |
| Author | remusao |
| Maintainers | berstend |
| Keywords | puppeteer, puppeteer-extra, puppeteer-extra-plugin, ads, adblocker, adblocking |

## Links

- npm: https://www.npmjs.com/package/puppeteer-extra-plugin-adblocker
- Repository: https://github.com/berstend/puppeteer-extra
- Homepage: https://github.com/berstend/puppeteer-extra/tree/master/packages/puppeteer-extra-plugin-adblocker
- Issues: https://github.com/berstend/puppeteer-extra/issues
- npm.io page: https://npm.io/package/puppeteer-extra-plugin-adblocker

## Dependencies (4)

- [debug](https://npm.io/package/debug.md) ^4.1.1
- [node-fetch](https://npm.io/package/node-fetch.md) ^2.6.0
- [puppeteer-extra-plugin](https://npm.io/package/puppeteer-extra-plugin.md) ^3.2.3
- [@cliqz/adblocker-puppeteer](https://npm.io/package/@cliqz/adblocker-puppeteer.md) 1.23.8

## Alternatives

- [@sapphire/ratelimits](https://npm.io/package/@sapphire/ratelimits.md) — 4.4K weekly downloads
- [js-csvparser](https://npm.io/package/js-csvparser.md) — 2.0K weekly downloads
- [@adadapted/js-sdk](https://npm.io/package/@adadapted/js-sdk.md) — 251 weekly downloads
- [@grapecity/spread-sheets-sparklines](https://npm.io/package/@grapecity/spread-sheets-sparklines.md) — 103 weekly downloads
- [@1selfworld/adchain-sdk-react-native](https://npm.io/package/@1selfworld/adchain-sdk-react-native.md) — 80 weekly downloads

## Recent versions

- 2.13.6 (latest) — 2023-03-01
- 2.13.5 — 2022-08-08
- 2.13.4 — 2022-07-08
- 2.13.3 — 2022-07-07
- 2.13.2 — 2022-07-07
- 2.13.1 — 2022-07-07
- 2.13.0 — 2022-06-20
- 2.12.0 — 2021-09-21
- 2.11.11 — 2021-03-14
- 2.11.10 — 2021-01-13
- 2.11.9 — 2020-11-21
- 2.11.8 — 2020-11-02
- 2.11.7 — 2020-10-29
- 2.11.6 — 2020-07-23
- 2.11.5 — 2020-07-09
- … 4 more at https://npm.io/package/puppeteer-extra-plugin-adblocker/versions

## README

# puppeteer-extra-plugin-adblocker [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/berstend/puppeteer-extra/test.yml?branch=master&event=push) [![Discord](https://img.shields.io/discord/737009125862408274)](https://extra.community) [![npm](https://img.shields.io/npm/v/puppeteer-extra-plugin-adblocker.svg)](https://www.npmjs.com/package/puppeteer-extra-plugin-adblocker)

> A [puppeteer-extra](https://github.com/berstend/puppeteer-extra) plugin to block ads and trackers.

## Features

- Extremely efficient adblocker (both in memory usage and raw speed)
- Pure JavaScript implementation
- Effectively blocks all types of ads and tracking
- Small and minimal (only 64KB minified and gzipped)

> Thanks to [@remusao](https://github.com/remusao) for contributing this sweet plugin and [adblocker engine](https://github.com/cliqz-oss/adblocker)! 👏

## Installation

```bash
yarn add puppeteer-extra-plugin-adblocker
# - or -
npm install puppeteer-extra-plugin-adblocker
```

If this is your first [puppeteer-extra](https://github.com/berstend/puppeteer-extra) plugin here's everything you need:

```bash
yarn add puppeteer puppeteer-extra puppeteer-extra-plugin-adblocker
# - or -
npm install puppeteer puppeteer-extra puppeteer-extra-plugin-adblocker
```

## Usage

The plugin enables adblocking in puppeteer, optionally blocking trackers.

```javascript
// puppeteer-extra is a drop-in replacement for puppeteer,
// it augments the installed puppeteer with plugin functionality
const puppeteer = require('puppeteer-extra')

// Add adblocker plugin, which will transparently block ads in all pages you
// create using puppeteer.
const { DEFAULT_INTERCEPT_RESOLUTION_PRIORITY } = require('puppeteer')
const AdblockerPlugin = require('puppeteer-extra-plugin-adblocker')
puppeteer.use(
  AdblockerPlugin({
    // Optionally enable Cooperative Mode for several request interceptors
    interceptResolutionPriority: DEFAULT_INTERCEPT_RESOLUTION_PRIORITY
  })
)

// puppeteer usage as normal
puppeteer.launch({ headless: true }).then(async browser => {
  const page = await browser.newPage()
  // Visit a page, ads are blocked automatically!
  await page.goto('https://www.google.com/search?q=rent%20a%20car')

  await page.waitForTimeout(5 * 1000)
  await page.screenshot({ path: 'response.png', fullPage: true })

  console.log(`All done, check the screenshots. ✨`)
  await browser.close()
})
```

<details>
 <summary><strong>TypeScript usage</strong></summary><br/>

```ts
import puppeteer from 'puppeteer-extra'
import Adblocker from 'puppeteer-extra-plugin-adblocker'

puppeteer.use(Adblocker({ blockTrackers: true }))

puppeteer
  .launch({ headless: false, defaultViewport: null })
  .then(async browser => {
    const page = await browser.newPage()
    await page.goto('https://www.vanityfair.com')
    await page.waitForTimeout(60 * 1000)
    await browser.close()
  })
```

</details>

## Options

Usage:

```js
const AdblockerPlugin = require('puppeteer-extra-plugin-adblocker')
const adblocker = AdblockerPlugin({
  blockTrackers: true // default: false
})
puppeteer.use(adblocker)
```

Available options:

```ts
interface PluginOptions {
  /** Whether or not to block trackers (in addition to ads). Default: false */
  blockTrackers: boolean
  /** Whether or not to block trackers and other annoyances, including cookie
      notices. Default: false */
  blockTrackersAndAnnoyances: boolean
  /** Persist adblocker engine cache to disk for speedup. Default: true */
  useCache: boolean
  /** Optional custom directory for adblocker cache files. Default: undefined */
  cacheDir?: string
}
```

## Motivation

Ads and trackers are on most pages and often cost a lot of bandwidth and time
to load pages. Blocking ads and trackers allows pages to load much faster,
because less requests are made and less JavaScript need to run. Also, in cases
where you want to take screenshots of pages, it's nice to have an option to
remove the ads before.

---
_Source: https://npm.io/package/puppeteer-extra-plugin-adblocker · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._