Brave Real Blocker

A 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.

Features

- 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.

Installation

``bash
npm install brave-real-blocker
`

Usage

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');
})();
`

Configuration

| 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. |

Testing

Run unit tests:
`bash
npm run test
`

Run visual verification on real sites:
`bash
npm run visual-test
``

Architecture

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.