| Category | Details |
|---|---|
| Ad Blocking | 110+ network rules — display, video (YouTube/Twitch), native, popup ads |
| Tracker Blocking | 80+ rules — GA, GTM, Facebook Pixel, Hotjar, Mixpanel, Segment, Amplitude… |
| Crypto Miner Blocking | 30 rules — Coinhive, CryptoLoot, JSECoin and 27 more |
| Cookie Banner Removal | 50+ frameworks — OneTrust, Cookiebot, Didomi, TrustArc, Quantcast, Axeptio, Osano, Civic, Usercentrics, generic GDPR banners |
| Anti-Adblock Bypass | Bait element injection, window property spoofing, overlay wall removal |
| Popup Blocking | Blocks window.open() calls without a user gesture |
| Notification Spam | Auto-denies browser notification permission requests from ad scripts |
| Cosmetic Filtering | 80+ CSS selectors injected to hide ad containers (incl. YouTube pre-roll) |
| Per-Site Whitelist | Pause blocking on any domain with one click |
| Custom Rules | AdBlock-style syntax (||example.com^) |
| Dark / Light Mode | Default dark, toggleable |
| Turkish + English | Full i18n — cookie banner detection works in both languages |
| Before ShieldBlock | After ShieldBlock |
|---|---|
Ad-heavy page with banners, trackers, and cookie consent popup |
Same page — ads removed, cookie banner dismissed, trackers blocked |
| Popup | Settings |
|---|---|
Live stats, per-site toggle, category toggles |
Whitelist, custom rules, import/export |
- Open Chrome and navigate to
chrome://extensions - Enable Developer mode (top-right toggle)
- Click Load unpacked
- Select the cloned
shieldblock/folder - The ShieldBlock icon appears in your toolbar
shieldblock/
├── manifest.json # MV3 manifest
├── background/
│ └── service-worker.js # Stats, badge, dynamic rules, messaging
├── content/
│ ├── cosmetic-filter.js # CSS injection + MutationObserver
│ ├── cookie-banner-blocker.js # 3-layer cookie banner detection/removal
│ └── anti-adblock.js # Bait element, property spoofing, overlay removal
├── popup/
│ ├── popup.html # Extension popup UI
│ ├── popup.css # Dark/light styles
│ └── popup.js # Popup logic
├── settings/
│ ├── settings.html # Full settings page
│ ├── settings.css
│ └── settings.js
├── rules/
│ ├── ads.json # 110 ad domain rules (IDs 1–110)
│ ├── trackers.json # 80 tracker rules (IDs 1001–1080)
│ └── miners.json # 30 miner rules (IDs 2001–2030)
├── assets/
│ ├── i18n.js # Shared EN/TR translation strings
│ ├── icons/
│ │ ├── icon.svg / icon16–128.svg
│ │ ├── icon16.png / icon32.png / icon48.png / icon128.png
│ └── screenshots/
│ ├── before.png # Before ShieldBlock
│ ├── after.png # After ShieldBlock
│ ├── popup.png # Popup UI
│ └── settings.png # Settings page
├── _locales/
│ ├── en/messages.json
│ └── tr/messages.json
└── README.md
Rules use Chrome's declarativeNetRequest API — the fastest, most efficient blocking method in MV3. All network blocking happens in the browser engine with zero JavaScript overhead at request time.
Covers all major programmatic ad networks:
doubleclick.net · googlesyndication.com · googleadservices.com · imasdk.googleapis.com · adnxs.com · appnexus.com · pubmatic.com · rubiconproject.com · openx.net · casalemedia.com · outbrain.com · taboola.com · criteo.com · amazon-adsystem.com · ads.yahoo.com · adform.net · doubleverify.com · moatads.com · sharethrough.com · triplelift.com · indexexchange.com · media.net · smartadserver.com · bidswitch.net · adroll.com + 85 more
Covers analytics, pixels, heatmaps, DMPs:
google-analytics.com · googletagmanager.com · connect.facebook.net · hotjar.com · mixpanel.com · segment.com · amplitude.com · fullstory.com · mouseflow.com · smartlook.com · crazyegg.com · quantserve.com · comscore.com · demdex.net · bluekai.com · lotame.com · liveramp.com · clarity.ms · bat.bing.com + 61 more
coinhive.com · coin-hive.com · authedmine.com · cryptoloot.pro · jsecoin.com · webmine.cz · minr.pw + 23 more (including pattern rules for coinhive.min.js, cryptonight*miner*)
Go to Settings → Custom Filter Rules and add one rule per line using AdBlock syntax:
| Syntax | Effect |
|---|---|
||example.com^ |
Block all requests to example.com |
@@||example.com^ |
Allow (whitelist) example.com |
||example.com/ads/ |
Block a specific path |
/banner_ad/ |
Block URLs containing "banner_ad" |
! comment |
Comment line — ignored |
Unlike content scripts that run JS on every request, declarativeNetRequest rules are evaluated natively by Chrome's network engine:
- Zero JS execution overhead per request
- Rules evaluated before the request is sent
- Works even when the service worker is inactive
Content scripts are used only for tasks that require DOM access:
cosmetic-filter.js— injects CSS, watches for new ad elements via MutationObservercookie-banner-blocker.js— detects/clicks/removes GDPR banners (3-layer: known selectors → heuristic z-index scan → MutationObserver)anti-adblock.js— injects bait element, spoofs globals, removes overlays
All run at document_start to act before ads render.
Stateless between activations. Session stats are stored in chrome.storage.session — they persist across service worker restarts within the same browser session and are automatically cleared when the browser closes. Global all-time stats are written to chrome.storage.local.
- Whitelist rules use IDs 9000+ with
priority: 2(allowaction), overriding static block rules - Custom block rules use IDs 8000+ with
priority: 1
| Permission | Why it's needed |
|---|---|
declarativeNetRequest |
Core ad/tracker blocking via rule engine |
declarativeNetRequestFeedback |
Track which rules fired for badge counts (dev mode) |
storage |
Persist settings and statistics locally |
tabs |
Read current tab URL for per-site whitelist toggle |
activeTab |
Access active tab info when popup opens |
scripting |
Inject content scripts on demand |
webNavigation |
Detect navigation events to reset session badge counts |
<all_urls> |
Apply blocking rules and content scripts on all HTTP/S pages |
No build step required. Edit files directly and reload the extension at chrome://extensions.
To inspect the service worker:
- Go to
chrome://extensions - Find ShieldBlock → click "Service Worker" link
- DevTools opens with the SW context
MIT License © 2026 Adil NAS
