Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/alexperezortuno/ce-blocker/llms.txt

Use this file to discover all available pages before exploring further.

Traffic Blocker is a Chrome Manifest V3 extension that gives you precise control over which network requests your browser makes. Using Chrome’s declarativeNetRequest API, it intercepts and blocks traffic matching your custom URL patterns — without slowing down your browsing or requiring page reloads.

Installation

Build from source and load the extension into Chrome in under five minutes.

Quickstart

Add your first blocking rule and see it take effect immediately.

Managing Rules

Add, edit, reorder, search, and delete URL blocking rules.

Preset Blocklists

One-click block lists for ads, trackers, social widgets, and malware.

Import & Export

Back up your rules as JSON or fetch blocklists from a remote URL.

Rule Schema

Full reference for the declarativeNetRequest rule format used by the extension.

What Traffic Blocker does

Every rule you add is translated directly into a Chrome declarativeNetRequest dynamic rule. Chrome enforces these rules at the network layer — matching happens before a request reaches the page, which means blocked resources never consume bandwidth or slow down rendering.

Wildcard URL patterns

Match entire domains, subpaths, or protocols with patterns like *://*.example.com/*.

Initiator filtering

Restrict blocking to requests that originate from specific domains, or exclude trusted initiators.

Priority ordering

Rules are matched in the order they appear. Move rules up or down to control which takes precedence.

Blocked counter

A live counter tracks every request blocked since the extension was installed, resettable any time.

Get started in three steps

1

Build and load the extension

Clone the repository, run npm run build, then load the dist/ folder as an unpacked extension in chrome://extensions.
2

Add your first rule

Open the extension popup, enter a URL pattern such as *://*.ads.example.com/*, and click Add rule.
3

Enable blocking

Flip the toggle switch to ON. Traffic Blocker immediately registers your rules with Chrome’s network layer.
Traffic Blocker stores all rules locally in chrome.storage.local. No data ever leaves your browser.

Build docs developers (and LLMs) love