Adblock Labs — Browser Blocking Test Suite

Internal test pages for verifying Adblock end-to-end blocking behaviour in Chrome.

Phase 1 pages

third-party-script — loads googletagmanager.com/gtag/js. Expected: blocked.
tracking-pixel — loads a 1×1 from google-analytics.com/collect. Expected: blocked.
allow-list-control — fetches a benign first-party asset. Expected: NOT blocked (over-blocking canary).

Phase 2 pages — network blocking surfaces

third-party-iframe — embeds a doubleclick.net ad iframe (iframe navigation block). Expected: blocked.
third-party-css — loads a stylesheet from googletagmanager.com (CSS request block). Expected: blocked.
beacon-tracker — navigator.sendBeacon POST to google-analytics.com/collect (POST beacon path). Expected: blocked.
xhr-fetch-tracker — explicit fetch with mode: 'cors' to google-analytics.com/collect (XHR/fetch path). Expected: blocked.
websocket-tracker — WebSocket upgrade to stats.g.doubleclick.net (WS upgrade block). Expected: blocked.
webworker-tracker — Worker sourced from googletagmanager.com (worker-script fetch). Expected: blocked.
video-tracker — <video> source from googleads.g.doubleclick.net (video-element URL block). Expected: blocked.
third-party-preconnect — preconnect/dns-prefetch to doubleclick.net with verification fetch (preconnect/DNS suppression). Expected: blocked.
no-referer-stress — same gtm.js load but with <meta name="referrer" content="no-referrer">; forces the proxy's ResolveTopLevelUrl heuristic to fall through to the request URL. Expected: blocked (rule has no $domain modifier), with host-level source-URL divergence in source-url-diff.summary.json.

Phase 3 pages — cosmetic filtering (ENG-697)

cosmetic-generic-hide — renders <div class="banner-ad">. EasyList's generic-hide rule ##.banner-ad should resolve the element to display: none. Expected: document loads, .banner-ad hidden.
cosmetic-ad-wrapper — renders <div class="ad-wrapper"> (##.ad-wrapper). Expected: .ad-wrapper hidden.
cosmetic-ad-slot — renders <div class="ad-slot"> (##.ad-slot). Expected: .ad-slot hidden.
cosmetic-ad-unit — renders <div class="ad-unit"> (##.ad-unit). Expected: .ad-unit hidden.
cosmetic-ad-zone — renders <div class="ad-zone"> (##.ad-zone). Expected: .ad-zone hidden.
cosmetic-id-adbanner — renders <div id="AdBanner"> (###AdBanner); exercises the ID-selector branch. Expected: #AdBanner hidden.
cosmetic-negative-control — renders a benign <div class="article-body"> not in any filter list. Expected: stays visible ("everything is hidden" over-blocking canary).
cosmetic-standard-strip — paired with a release-test staged list containing a plain hide rule and a procedural :has() rule. Expected under Standard: plain marker hidden; procedural marker and real content visible.

Phase 4 — real-site list

Curated list of real-world sites the release-tests crawler can visit. Served as JSON from /phase4-sites (parsed from pages/phase4-sites.yaml).

Social embeds — Brave `$tag=` unbreak (ENG-1000 / ENG-1006)

Over-blocking canaries for the social-embed $tag= set shipped in enabledFilterTags. Each loads a provider's canonical widget script and reports loaded=true only if the script actually executed (defined its global) — an empty-200 stub fires onload but can't define the global, so a silent over-block is caught. Requires a build whose proxysettings.json enables the corresponding tag.

social-embed-facebook — loads connect.facebook.net/en_US/sdk.js (fb-embeds), expects window.FB. Expected: NOT blocked.
social-embed-twitter — loads platform.twitter.com/widgets.js (twitter-embeds), expects window.twttr. Expected: NOT blocked.
social-embed-linkedin — loads platform.linkedin.com/in.js (linked-in-embeds), expects window.IN. Expected: NOT blocked (ENG-1006 prod canary).

HTTPS-filtering toggle canaries (ENG-848)

Pages whose expected verdict flips with the user's filter_encrypted_traffic setting. The runner drives them once with the toggle on and once with it off, asserting opposite verdicts.

https-encrypted-ad — same gtm.js subresource as third-party-script, named to signal it's the HTTPS-on/off canary. Expected: blocked when HTTPS filtering is on; loaded (and served from real upstream) when off.
cosmetic-https-toggle-canary — renders .banner-ad (EasyList ##.banner-ad) to exercise generic-hide cosmetic filtering. Expected: hidden when HTTPS filtering is on; visible when off (proxy can't inject styles on a stream it doesn't decrypt).

Note: these pages are consumed by BlockingRecorder in Adblock.ReleaseTests. They report verdicts via window.__adblockTestResult and are evaluated against CDP Network.loadingFailed events. Manual visits are fine for sanity checks; meaningful pass/fail comes from the automated runner. See Linear ENG-682 (page suite), ENG-697 (cosmetic phase 3), ENG-698 (phase 4 real-site list), ENG-848 (HTTPS toggle canaries).