puppeteer-extra-plugin-adblocker [

A 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 for contributing this sweet plugin and adblocker engine! 👏

Installation

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

If this is your first puppeteer-extra plugin here's everything you need:

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.

// 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()
})

TypeScript usage

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()
  })

Options

Usage:

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

Available options:

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.