Advanced uBlock Origin management and stealth features for Brave Real Browser
npm install brave-real-blockerA powerful ad-blocking and stealth library for Brave Real Browser, based on uBlock Origin filtering logic.
This package replaces the traditional uBlock Origin extension with a native Node.js implementation using @cliqz/adblocker and custom scriptlet injections.
- Core Filtering: Uses uBlock Origin compatible filter lists (EasyList, EasyPrivacy, uBlock filters).
- Stealth Mode: Advanced fingerprinting protection (Canvas, WebGL, AudioContext noise).
- Scriptlet Injection:
- Blocks forced button clicks.
- Prevents auto-tab opening loops.
- Intercepts forced redirects.
- Visual Blocker: Removes "Sponsored" and ad placeholders cosmetically.
- URL Cleaner: Removes tracking parameters (utm_, fbclid) from URLs.
``bash`
npm install brave-real-blocker
This library is automatically integrated into brave-real-browser.
To use it manually with Puppeteer:
`typescript
import { BraveBlocker } from 'brave-real-blocker';
import puppeteer from 'puppeteer-core';
(async () => {
const browser = await puppeteer.launch();
const page = await browser.newPage();
const blocker = new BraveBlocker({
enableStealth: true,
enableScriptlets: true
});
await blocker.init(); // Downloads latest lists
await blocker.enable(page);
await page.goto('https://example.com');
})();
`
| Option | Type | Default | Description |
|--------|------|---------|-------------|
| enableAdBlocking | boolean | true | Enables standard network request blocking (Ads/Trackers). |enableStealth
| | boolean | true | Enables anti-fingerprinting and bot evasion techniques. |enableScriptlets
| | boolean | true | Enables injection of scriptlets to block forced clicks and popups. |enableCosmeticFiltering
| | boolean | true | Hides cosmetic elements like "Sponsored" labels or empty ad slots. |enableRedirectBlocking
| | boolean | true | Prevents forced tab openings and cleans tracking parameters from URLs. |
Run unit tests:
`bash`
npm run test
Run visual verification on real sites:
`bash``
npm run visual-test
This package is part of the Brave Real Browser ecosystem. It runs as a library hooking into Puppeteer's request interception and page evaluation APIs, providing a faster and more undetectable experience than loading the full chrome extension.