Skip to content

Repository files navigation

Zorilla

npm npm License: MIT Biome Node.js CI

Zorilla

Zorilla is a modular plugin framework that extends Puppeteer and Playwright with additional functionality through a clean plugin architecture. Build powerful browser automation with composable plugins for stealth mode, captcha solving, ad blocking, and much more.

Note

About this fork: This project is a maintained hard fork of the excellent puppeteer-extra originally created by Tobias Buschor (@berstend). The original project pioneered the modular plugin architecture for Puppeteer. This fork exists to continue maintenance, provide bug fixes, and keep dependencies up to date with modern Puppeteer and Playwright versions. All credit for the original architecture and design goes to the original puppeteer-extra team.


πŸ“¦ Available Packages

Core Frameworks

Package Description Version
@zorilla/puppeteer-extra Modular plugin framework for Puppeteer npm
@zorilla/playwright-extra Modular plugin framework for Playwright npm
@zorilla/puppeteer-extra-plugin Base class for creating puppeteer-extra plugins npm

Plugins

Package Description Version
@zorilla/puppeteer-extra-plugin-stealth Apply various techniques to make headless detection harder npm
@zorilla/puppeteer-extra-plugin-recaptcha Automatically solve reCAPTCHAs and hCaptchas npm
@zorilla/puppeteer-extra-plugin-adblocker Block ads and trackers using Cliqz adblocker npm
@zorilla/puppeteer-extra-plugin-block-resources Block resources like images, media, fonts, etc. npm
@zorilla/puppeteer-extra-plugin-anonymize-ua Anonymize and customize the User-Agent header npm
@zorilla/puppeteer-extra-plugin-user-preferences Launch with arbitrary Chrome user preferences npm
@zorilla/puppeteer-extra-plugin-user-data-dir Manage custom user data directories npm
@zorilla/puppeteer-extra-plugin-repl Start an interactive REPL for debugging npm
@zorilla/puppeteer-extra-plugin-devtools Remote debugging with secure DevTools tunnels npm
@zorilla/puppeteer-extra-plugin-flash Allow Flash on all sites without user interaction npm
@zorilla/puppeteer-extra-plugin-font-size Adjust font sizes in the browser npm
@zorilla/puppeteer-extra-plugin-click-and-wait Wait for navigation to complete after clicking npm
@zorilla/proxy-router Route proxies dynamically in Puppeteer & Playwright npm

Utilities

Package Description Version
@zorilla/extract-stealth-evasions Extract stealth evasions as standalone JavaScript npm

Conformance testing

@zorilla/stealth-tests provides deterministic, Zorilla-owned stealth probes for Chromium through Puppeteer and Playwright. CI release-gates these probes and publishes versioned JSON plus human-readable Markdown reports. See the stealth test documentation for local commands and the result metadata contract.


πŸš€ Quick Start

With Puppeteer

npm install puppeteer @zorilla/puppeteer-extra @zorilla/puppeteer-extra-plugin-stealth
import puppeteer from '@zorilla/puppeteer-extra'
import StealthPlugin from '@zorilla/puppeteer-extra-plugin-stealth'

puppeteer.use(StealthPlugin())

const browser = await puppeteer.launch({ headless: true })
const page = await browser.newPage()
await page.goto('https://example.com')
await browser.close()

With Playwright

npm install playwright @zorilla/playwright-extra @zorilla/puppeteer-extra-plugin-stealth
import { chromium } from '@zorilla/playwright-extra'
import StealthPlugin from '@zorilla/puppeteer-extra-plugin-stealth'

chromium.use(StealthPlugin())

const browser = await chromium.launch()
const page = await browser.newPage()
await page.goto('https://example.com')
await browser.close()

🀝 Contributing

We welcome contributions! Read the Contributing Guide β†’

πŸ”’ Security

To report a vulnerability, please follow the Security Policy and avoid filing public issues for suspected security problems.

License

MIT

About

Zorilla is a modular plugin framework that extends Puppeteer and Playwright with additional functionality through a clean plugin architecture. Build powerful browser automation with composable plugins for stealth mode, captcha solving, ad blocking, and much more.

Topics

Resources

Contributing

Security policy

Stars

31 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages