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.
• youtube-player-response — fetches a YouTube-shaped /youtubei/v1/player fixture. Expected with the release-test staged list: ad response fields pruned, content fields preserved.
• 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 a plain-text, resource-free <div id="navAdBanner"> (###navAdBanner, EasyList generic); exercises the ID-selector branch and the Standard-mode first-party un-hide. Expected: hidden first; in Standard, visible on the settled read (≥3 s after load), as in Brave.
• cosmetic-id-adbanner-3p — same match, banner holds a cross-origin image (from test-adblock.org) and the label “Ad”. Expected: hidden, and still hidden on the settled read (un-hide over-fire control).
• cosmetic-id-adbanner-1p — same match, banner holds a same-origin image and the label “Ad”. Expected: hidden first; in Standard, visible on the settled read (first-party-resource branch).
• 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-zstd-generic-hide — the cosmetic-ad-zone element and rule, served with Content-Encoding: zstd from pre-compressed bytes (Worker route). Expected: .ad-zone hidden; visible here while cosmetic-ad-zone is hidden means the proxy passed the zstd document through unrewritten. Not a Brave-comparison fixture (transport only).
• 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.

Cosmetic rule tiers and element subtrees (ENG-2306)

One behaviour per page. Each page's expectation, the rule it depends on and Brave's verdict (measured, hypothesis or source-derived) are in cosmetic-fixtures.json. Shipped pages use rules both catalogs ship; staged pages need the rules the release test stages, so opened by hand they show no rule applied.

• cosmetic-tier-generic-exception (shipped) — ##.display_ad plus uBO's generic #@#.display_ad, which adblock-rust drops. Expected: hidden.
• cosmetic-tier-domain-exception-control (shipped) — ###AdRectangleBanner, no exception. Expected: hidden.
• cosmetic-tier-generichide (shipped) — EasyList @@://localhost/$generichide matched through the query. Expected: generic class and id targets visible.
• cosmetic-tier-generichide-split (shipped) — the default engine's $generichide leaves the force engine's [id^="div-gpt-ad"]. Expected: id target hidden, class target visible.
• cosmetic-subtree-known-ad-id (shipped) — ###AdTopLeader with a div-gpt-ad… child and the label “Ad”. Expected: hidden.
• cosmetic-subtree-known-ad-id-text (shipped) — the same plus a sentence of significant text. Expected: Standard hidden, then visible.
• cosmetic-subtree-style-url (shipped) — ###AdvertPanel with a first-party style="…url(…)". Expected: hidden.
• cosmetic-subtree-late-insert (shipped) — ###AdSkyscraper inserted 2 s after load. Hypothesis: Standard hidden, then visible.
• cosmetic-subtree-xorigin-iframe (shipped) — ###AdBillboard holding an iframe from test-adblock.org (frame page) and the label “Ad”. Expected: hidden.
• cosmetic-subtree-text-3p-image (shipped) — ###navAdBanner holding an image from test-adblock.org and a sentence of significant text. Expected: Standard hidden, then visible.
• cosmetic-subtree-in-xorigin-frame (shipped) — plain ###navAdBanner inside a frame from other.test-adblock.com (inner page). Expected: hidden.
• cosmetic-tier-domain-force (staged, force) — test-adblock.com##.eng2306-domain-force. Expected: hidden.
• cosmetic-tier-domain-default (staged, un-hideable) — test-adblock.com##.eng2306-domain-default. Expected: Standard hidden, then visible (Brave source-derived).
• cosmetic-tier-domain-exception (staged, on sub.test-adblock.com) — a force-tier #@# cancels EasyList's ###AdRectangleBanner. Expected: visible.
• cosmetic-tier-has-default (staged, un-hideable) — primary :has(). Expected: Standard visible, Aggressive hidden (source-derived).
• cosmetic-tier-procedural-default (staged, un-hideable) — primary :has-text() and :upward(). Expected: Standard visible, Aggressive hidden (source-derived).
• cosmetic-tier-procedural-force (staged, force) — force-engine :has-text(). Expected: hidden.
• cosmetic-tier-scriptlet-default (staged, un-hideable) — primary-engine set-constant. Expected: marker hidden (source-derived).
• cosmetic-tier-scriptlet-force (staged, force) — force-engine set-constant. Expected: marker hidden.
• cosmetic-tier-action-force (staged, force) — :style() and :remove(). Expected: styled target hidden, removed target gone.
• cosmetic-tier-action-default (staged, un-hideable) — the same in the primary engine. Expected: styled target hidden, removed target gone (source-derived).

Blocked-document page (Networking #158)

• document-block — target of the DocumentBlock release test, which stages ||test-adblock.com^$document. A typed navigation gets the proxy's branded block page; after "Continue for five minutes" this page loads, its first-party image loads (a staged $important rule blocks it without the grant) and the third-party pixel stays blocked. Expected with no staged list: page loads, pixel blocked.

Hostile cosmetic runtime pages (ENG-1578)

• cosmetic-runtime-var-w — declares classic-script var W after the injected runtime. Expected: page liveness sentinel executes with no page error.
• cosmetic-runtime-var-cc — independently declares classic-script var CC. Expected: page liveness sentinel executes with no page error.
• cosmetic-procedural-apply — paired with a staged Aggressive-mode :has-text() rule. Expected: procedural marker hidden after runtime/helper initialization.

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