Jak vytvářet vlastní filtry reklam

informace

V tomto článku vysvětlíme, jak napsat vlastní pravidla filtrování pro použití v produktech AdGuardu. Chcete-li otestovat svá pravidla, stáhněte si aplikaci AdGuard

Filtr je sada pravidel filtrování aplikovaných na konkrétní obsah, například bannery nebo vyskakovací okna. AdGuard má seznam standardních filtrů vytvořených naším týmem. Neustále je vylepšujeme, aktualizujeme a snažíme se vyhovět potřebám většiny našich uživatelů.

AdGuard zároveň umožňuje vytvářet vlastní filtry pomocí stejných typů pravidel, které máme v našich filtrech.

K popisu syntaxe našich pravidel filtrování používáme Augmented BNF for Syntax Specifications, ale ne vždy se touto specifikací striktně řídíme.

informace

Původně byla syntaxe AdGuardu založena na syntaxi pravidel Adblock Plus. Později jsme ji rozšířili o nové typy pravidel pro lepší filtrování reklam. Některé části tohoto článku o pravidlech společných pro AdGuard i ABP byly převzaty z příručka Adblock Plus o tom, jak psát filtry.

Komentáře

Každý řádek začínající vykřičníkem je komentář. V seznamu pravidel je zobrazen šedou barvou. AdGuard bude tento řádek ignorovat, takže můžete napsat cokoli chcete. Komentáře se obvykle umísťují nad pravidla a slouží k popisu toho, co pravidlo dělá.

Např:

! Toto je komentář. Pod tímto řádkem se nachází skutečné pravidlo filtrování.
||example.org^

Příklady

Blokování podle názvu domény

Blocking by domain name

Toto pravidlo blokuje:

http://example.org/ad1.gif
http://subdomain.example.org/ad1.gif
https://ads.example.org:8000/

Toto pravidlo neblokuje:

http://ads.example.org.us/ad1.gif
http://example.com/redirect/http://ads.example.org/

Ve výchozím nastavení tato pravidla pro žádosti o dokumenty nefungují. To znamená, že pravidlo ||example.org^ zablokuje požadavek na example.org při pokusu o přechod na tuto doménu z jiné webové stránky, ale pokud do adresního řádku zadáte example.org a pokusíte se na doménu přejít, webová stránka se otevře. Chcete-li zablokovat žádost o dokument, budete muset použít pravidlo s modifikátorem $document: ||example.org^$document.

Blokování přesné adresy

Blocking exact address

Toto pravidlo blokuje:

http://example.org/

Toto pravidlo neblokuje:

https://example.org/banner/img

Modifikátory základních pravidel

Pravidla filtrování podporují řadu modifikátorů, které umožňují doladit chování pravidla. Zde je příklad pravidla s několika jednoduchými modifikátory.

Modifikátory základních pravidel

Toto pravidlo blokuje:

http://example.org/script.js, pokud je tento skript načten z example.com.

Toto pravidlo neblokuje:

https://example.org/script.js, pokud je tento skript načten z example.org.
https://example.org/banner.png, protože se nejedná o skript.

Odblokování adresy

Toto pravidlo odblokuje:

http://example.org/banner.png, i když pro tuto adresu existuje pravidlo blokování.

Pravidla blokování s modifikátorem $important mohou přepsat výjimky.

Odblokování celé webové stránky

Toto pravidlo odblokuje

Zakáže všechna kosmetická pravidla na example.com.
Odblokuje všechny požadavky odeslané z této webové stránky, i když existují pravidla blokování odpovídající těmto požadavkům.

Kosmetické pravidlo

Cosmetic rule

Kosmetická pravidla jsou založena na použití speciálního jazyka CSS, kterému rozumí každý prohlížeč. V podstatě přidává na webové stránky nový styl CSS, jehož účelem je skrýt určité prvky. Více o CSS obecně se můžete dozvědět zde.

AdGuard rozšiřuje CSS a umožňuje tak vývojářům filtrů řešit mnohem složitější případy. Abyste však mohli tato rozšířená pravidla používat, musíte ovládat běžný jazyk CSS.

Oblíbené selektory CSS

Název	Selektor CSS	Popis
ID selector	`#banners`	Shoduje se se všemi prvky s atributem `id` rovným `banners`.
Class selector	`.banners`	Shoduje se se všemi prvky s atributem `class` obsahujícím `banners`.
Attribute selector	`div[class="banners"]`	Shoduje se se všemi prvky `div` s atributem `class` přesně rovným k `banners`.
Attribute substring selector	`div[class^="advert1"]`	Shoduje se se všemi prvky `div` s atributem `class` začínajícím na řetězec `advert1`.
Attribute substring selector	`div[class$="banners_ads"]`	Shoduje se se všemi prvky `div` s atributem `class` končícím na řetězec `banners_ads`.
Attribute substring selector	`a[href^="http://example.com/"]`	Shoduje se se všemi odkazy načtenými z domény `http://example.com/`.
Attribute selector	`a[href="http://example.com/"]`	Shoduje se se všemi odkazy exactly adresy `http://example.com/`.

Omezení a restrikce

Důvěryhodné filtry

Některá pravidla lze použít pouze v důvěryhodných filtrech. Tato kategorie zahrnuje:

seznamy filtrů vytvořené týmem AdGuard,
seznamy vlastních filtrů nainstalované jako trusted,
uživatelská pravidla.

Blokátor obsahu AdGuard

Blokátor obsahu AdGuard je rozšíření pro prohlížeče Samsung a Yandex, které lze nainstalovat z Google Play. Nesmí se zaměňovat s plně funkčním nástrojem AdGuard pro Android, který lze stáhnout pouze z našich stránek. Bohužel, funkce Blokátoru obsahu AdGuard jsou omezeny tím, co prohlížeče umožňují a podporují pouze starou syntaxi filtrů Adblock Plus:

Základní pravidla blokování s následujícími modifikátory: $domain, $third-party, modifikátory typu obsahu.
Základní pravidla výjimek s následujícími modifikátory: $document, $elemhide.
Základní pravidla pro skrývání prvků bez rozšířené podpory CSS.

Vzhledem k výše uvedeným omezením nebude Blokátor obsahu AdGuard uveden v poznámkách ke kompatibilitě.

Základní pravidla

Nejjednoduššími pravidly jsou tzv. základní pravidla. Slouží k blokování požadavků na konkrétní adresy URL. Nebo je odblokují, pokud je na začátku pravidla speciální znak "@@". Základní princip tohoto typu pravidel je poměrně jednoduchý: je třeba zadat adresu a další parametry, které omezují nebo rozšiřují rozsah pravidla.

Dílčí požadavky

Základní pravidla pro blokování požadavků se vztahují pouze na dílčí požadavky. To znamená, že nebudou blokovat načítání stránky, pokud není výslovně zadána pomocí modifikátoru $document.

Stav odpovědi

Prohlížeč rozpozná zablokovaný požadavek jako dokončený s chybou.

Délka pravidla

Pravidla kratší než 4 znaky jsou považována za nesprávná a budou ignorována.

Syntaxe základních pravidel

      rule = ["@@"] pattern [ "$" modifiers ]
modifiers = [modifier0, modifier1[, ...[, modifierN]]]

pattern — maska adresy. Každá adresa URL požadavku je přiřazena k této masce. V šabloně můžete také použít speciální znaky popsané níže. Vezměte na vědomí, že AdGuard zkracuje adresy URL na délku 4096 znaků, aby urychlil porovnávání a předešel problémům s nesmyslně dlouhými adresami URL.
@@ — znak, který se používá v pravidlech výjimek. Chcete-li filtrování požadavku vypnout, začněte pravidlo touto značkou.
modifiers — parametry, které "objasňují" základní pravidlo. Některé z nich omezují rozsah pravidel a některé mohou zcela změnit jejich fungování.

Speciální znaky

* — zástupný znak. Používá se k reprezentaci libovolné sady znaků. Může to být také prázdný řetězec nebo řetězec libovolné délky.
|| — indikace o použití pravidla na zadanou doménu a její subdomény. S tímto znakem nemusíte v masce adresy zadávat konkrétní protokol a subdoménu. Tj., že || znamená http://*., https://*., ws://*., wss://*. najednou.
^ — oddělovací znak. Oddělovací znak je libovolný znak, mimo písmeno, číslice nebo jeden z následujících znaků: _ - . %. V tomto příkladu jsou oddělovací znaky zobrazeny tučně: http://example.com/?t=1&t2=t3. Konec adresy je také akceptován jako oddělovací znak.
| — ukazatel na začátku nebo konci adresy. Hodnota závisí na umístění znaku v masce. Např. pravidlo swf| odpovídá http://example.com/annoyingflash.swf, ale neodpovídá http://example.com/swf/index.html. |http://example.org odpovídá http://example.org, ale ne http://domain.com?url=http://example.org.

poznámka

|, ||, ^ lze použít pouze u pravidel se vzorem URL. Např. ||example.com##.advert je nesprávný a bude blokátorem ignorován.

Vizuální znázornění

Doporučujeme také seznámit se s přehledem filtrů Adblock Plus, abyste lépe pochopili, jak taková pravidla vytvářet.

Podpora regulárních výrazů

Pokud chcete ještě větší flexibilitu při vytváření pravidel, můžete použít regulární výrazy namísto výchozí zjednodušené masky se speciálními znaky.

Výkon

Pravidla s regulárními výrazy pracují pomaleji, proto se jim doporučuje vyhnout nebo omezit jejich rozsah na určité domény.

Pokud chcete, aby blokátor určil regulární výraz, musí pattern vypadat takto:

pattern = "/" regexp "/"

Např. pravidlo /banner\d+/$third-party použije regulární výraz banner\d+ na všechny požadavky třetích stran. Pravidlo výjimky s regulárním výrazem vypadá takto: @@/banner\d+/.

Kompatibilita

AdGuard pro Safari a AdGuard pro iOS plně nepodporují regulární výrazy kvůli omezení API pro blokování obsahu (hledejte sekci "Formát regulárního výrazu").

Podpora zástupných znaků pro TLD (domény nejvyšší úrovně)

Zástupné znaky jsou podporovány pro TLD domén ve vzorech kosmetických, filtrování HTML a pravidel JavaScript.

V případě kosmetických pravidel, např. example.*##.banner, je díky znaku .*, tj. example.com, sub.example.net, example.co.uk, atd. přiřazeno více domén.

Pro základní pravidla platí popsaná logika pouze pro domény uvedené v $domain modifikátoru, např. ||*/banners/*$image,domain=example.*.

Kompatibilita

V AdGuardu pro Windows, Mac, Android a v pravidlech rozšíření prohlížeče AdGuard se zástupným znakem .*, odpovídá jakékoli veřejné příponě (nebo eTLD). Pro AdGuard pro Safari a iOS je však seznam podporovaných domén nejvyšší úrovně omezen kvůli omezením v Safari.

Pravidla se zástupným znakem pro TLD nejsou podporována Blokátorem obsahu AdGuard.

Příklady základních pravidel

||example.com/ads/* — jednoduché pravidlo, které odpovídá adresám typu http://example.com/ads/banner.jpg a dokonce i http://subdomain.example.com/ads/otherbanner.jpg.
||example.org^$third-party — toto pravidlo blokuje požadavky třetích stran na example.org a jejím subdoménám.
@@||example.com$document — obecné pravidlo výjimky. Zcela vypne filtrování pro example.com a všechny subdomény. V pravidlech pro výjimky lze použít řadu modifikátorů. Pro více podrobností klikněte na odkaz níže.

poznámka

Funkce popsané v této části jsou určeny pro zkušené uživatele. Rozšiřují možnosti "základních pravidel", ale abyste je mohli používat, musíte mít základní znalosti o fungování prohlížeče.

Chování "základního pravidla" můžete změnit pomocí dalších modifikátorů. Modifikátory by měly být umístěny na konci pravidla za znakem $ a odděleny čárkami.

Příklad:

||domain.com^$popup,third-party

Základní modifikátory

Následující modifikátory jsou nejjednodušší a nejčastěji používané. V podstatě jen omezují rozsah použití pravidel.

Modifikátor \ Produkty	Aplikace CoreLibs	AdGuard pro Chromium	AdGuard pro Chrome MV3	AdGuard pro Firefox	AdGuard pro iOS	AdGuard pro Safari	Blokátor obsahu AdGuard
$app	✅	❌	❌	❌	❌	❌	❌
$denyallow	✅	✅	✅	✅	✅	✅	❌
$domain	✅	✅	✅ *[1]	✅	✅ *[1]	✅ *[1]	✅
$header	✅	✅ *[2]	❌	✅ *[2]	❌	❌	❌
$important	✅	✅	✅	✅	✅	✅	❌
$match-case	✅	✅	✅	✅	✅	✅	✅
$method	✅	✅	✅	✅	❌	❌	❌
$popup	✅ *[3]	✅	✅ *[3]	✅	✅ *[3]	✅ *[3]	❌
$strict-first-party	⏳	❌	❌	❌	❌	❌	❌
$strict-third-party	⏳	❌	❌	❌	❌	❌	❌
$third-party	✅	✅	✅	✅	✅	✅	✅
$to	✅	✅	✅	✅	❌	❌	❌

poznámka

✅ — plně podporováno
✅ * — podporováno, ale spolehlivost se může lišit nebo se mohou vyskytnout omezení; více informací naleznete v popisu modifikátoru
⏳ - funkce, jejíž implementace se plánuje, ale zatím není k dispozici v žádném produktu
❌ — nepodporováno

`$app`

Tento modifikátor umožňuje zúžit pokrytí pravidla na konkrétní aplikaci (nebo seznam aplikací). V systémech Windows a Mac to nemusí být příliš důležité, ale v mobilních zařízeních, kde některá pravidla filtrování musí být specifická pro konkrétní aplikaci, je to velmi důležité.

Android — použijte název balíčku aplikace, např. org.example.app.
Windows — použijte název procesu, např. chrome.exe.
Mac — použijte ID svazku nebo název procesu, např. com.google.Chrome.

V případě počítače Mac můžete ID svazku nebo název procesu aplikace zjistit zobrazením příslušných podrobností o požadavku v záznamu filtrování.

Příklady

||baddomain.com^$app=org.example.app — pravidlo pro blokování požadavků, které odpovídají zadané masce a jsou odeslány z Android aplikace org.example.app.
||baddomain.com^$app=org.example.app1|org.example.app2 — stejné pravidlo, ale funguje jak pro org.example.app1, tak i pro org.example.app2.

Pokud chcete, aby se pravidlo nevztahovalo na určité aplikace, začněte název aplikace znakem ~.

||baddomain.com^$app=~org.example.app — pravidlo pro blokování požadavků, které odpovídají zadané masce a jsou odeslány z jakékoli aplikace kromě org.example.app.
||baddomain.com^$app=~org.example.app1|~org.example.app2 — stejně jako výše, ale nyní jsou vyloučeny dvě aplikace: org.example.app1 a org.example.app2.

Omezení

Aplikace v hodnotě modifikátoru nemohou mít zástupný znak, např. $app=com.*.music. Pravidla s takovým modifikátorem jsou považována za neplatná.

Kompatibilita

Pouze AdGuard pro Windows, Mac a Android jsou technicky schopné používat pravidla s modifikátorem $app.
V systému Windows se v názvu procesu nerozlišují velká a malá písmena, počínaje AdGuard pro Windows s CoreLibs v1.12 nebo novější.

`$denyallow`

Modifikátor $denyallow umožňuje vyhnout se vytváření dalších pravidel, pokud je potřeba zakázat určité pravidlo pro konkrétní domény. $denyallow odpovídá pouze cílovým doménám, nikoli doménám odkazujícím.

Přidání tohoto modifikátoru k pravidlu je ekvivalentní vyloučení domén podle shodného vzoru pravidla nebo přidání odpovídajících pravidel výjimek. Chcete-li do jednoho pravidla přidat více domén, použijte jako oddělovací znak |.

Příklady

Toto pravidlo:

*$script,domain=a.com|b.com,denyallow=x.com|y.com

odpovídá tomuto:

/^(?!.*(x.com|y.com)).*$/$script,domain=a.com|b.com

nebo kombinaci těchto tří:

*$script,domain=a.com|b.com
@@||x.com$script,domain=a.com|b.com
@@||y.com$script,domain=a.com|b.com

Omezení

Vzor shody pravidla se nemůže zaměřit na žádné konkrétní domény, např. nemůže začínat ||.
Domény v hodnotě modifikátoru nemohou být negovány, např. $denyallow=~x.com, nebo mít zástupný znak TLD, např. $denyallow=x.*, nebo být regulárním výrazem, např. ;$denyallow=/\.(com\|org)/.
$denyallow nelze použít společně s $to. Lze ji vyjádřit pomocí invertovaného $to: $denyallow=a.com|b.com, což je je ekvivalent k $to=~a.com|~b.com.

Pravidla, která tato omezení porušují, jsou považována za neplatná.

Kompatibilita

Pravidla s modifikátorem $denyallow nejsou AdGuardem pro iOS, Safari a Blokátorem obsahu AdGuard podporována.

`$domain`

$domain omezuje rozsah pravidla na požadavky ze zadaných domén a jejich subdomén (jak je uvedeno v záhlaví Referer HTTP).

Syntaxe

Modifikátor je seznam jednoho nebo více výrazů oddělených symbolem |, z nichž každý je porovnáván s doménou určitým způsobem v závislosti na svém typu (viz níže).

domains = ["~"] entry_0 ["|" ["~"] entry_1 ["|" ["~"]entry_2 ["|" ... ["|" ["~"]entry_N]]]]
entry_i = ( regular_domain / any_tld_domain / regexp )

regular_domain — běžný název domény (domain.com). Odpovídá zadané doméně a jejím subdoménám. Shoduje se lexikograficky.
any_tld_domain — název domény zakončený zástupným znakem jako veřejná přípona, např. pro example.* je to co.uk v example.co.uk. Odpovídá zadané doméně a jejím subdoménám s libovolnou veřejnou příponou. Shoduje se lexikograficky.
regexp — regulární výraz, který začíná a končí znakem /. Vzor funguje stejně jako v základních pravidlech URL, ale znaky /, $, , a | musí být uvozeny pomocí \.

informace

Pravidla s modifikátorem $domain jako regular_domain jsou podporována všemi AdGuard produkty.

Příklady

Jen $domain:

||baddomain.com^$domain=example.org blokuje požadavky, které odpovídají zadané masce a jsou odeslány z domény example.org nebo jejích subdomén.
||baddomain.com^$domain=example.org|example.com — stejné pravidlo, ale funguje jak pro example.org, tak i pro example.com.

Pokud chcete, aby se pravidlo nevztahovalo na určité domény, začněte název domény znakem ~.

$domain a negace ~:

||baddomain.com^$domain=example.org blokuje požadavky, které odpovídají zadané masce a jsou odeslány z domény example.org nebo jejích subdomén.
||baddomain.com^$domain=example.org|example.com — stejné pravidlo, ale funguje jak pro example.org, tak i pro example.com.
||baddomain.com^$domain=~example.org blokuje požadavky, které odpovídají vzoru a jsou odeslané z jakékoli domény kromě example.org a jejích subdomén.
||baddomain.com^$domain=example.org|~foo.example.org blokuje požadavky odeslané z example.org a jích subdomén, kromě subdomény foo.example.org.
||baddomain.com^$domain=/(^\|.+\.)example\.(com\|org)\$/ blokuje požadavky odeslané z example.org a example.com a všech jejích subdomén.
||baddomain.com^$domain=~a.com|~b.*|~/(^\|.+\.)c\.(com\|org)\$/ blokuje požadavky odeslané z a.com, b s libovolnou veřejnou příponou (b.com, b.co.uk, etc.), c.com, c.org, a jejich subdomén.

$domain modifikátor odpovídající cílové doméně:

V některých případech může modifikátor $domain odpovídat nejen doméně odkazovače, ale také cílové doméně. K tomu dojde, pokud jsou splněny všechny následující podmínky:

Požadavek má typ obsahu document
Vzor pravidla neodpovídá žádné konkrétní doméně
Vzor pravidla neobsahuje regulární výrazy
Modifikátor $domain obsahuje pouze domény ve výjimkách, např. $domain=~example.org|~example.com

Následující predikát by měl být splněn, aby bylo možné provést porovnání cílové domény:

1 AND ((2 AND 3) OR 4)

To znamená, že pokud modifikátor $domain obsahuje pouze domény ve výjimkách, pak pravidlo nemusí splňovat druhou a třetí podmínku, aby se cílová doména shodovala s modifikátorem $domain.

Pokud některé z výše uvedených podmínek nejsou splněny, ale pravidlo obsahuje modifikátor $cookie nebo $csp, cílová doména bude přesto přiřazena.

Pokud odkazující doména odpovídá pravidlu s $domain, které výslovně vylučuje doménu odkazujícího serveru, pravidlo se nepoužije, i když cílová doména také odpovídá pravidlu. To má vliv i na pravidla s modifikátory $cookie a $csp.

Příklady

*$cookie,domain=example.org|example.com zablokuje soubory cookie pro všechny požadavky do a z domény example.org a example.com.
*$document,domain=example.org|example.com zablokuje všechny požadavky do a z domény example.org a example.com.

V následujících příkladech se předpokládá, že požadavky jsou odesílány z adresy http://example.org/page (odkazující adresa), cílová adresa URL je http://targetdomain.com/page.

page$domain=example.org bude přiřazena, protože odpovídá doméně odkazu.
page$domain=targetdomain.com bude přiřazena, protože odpovídá cílové doméně a splňuje všechny výše uvedené požadavky.
||*page$domain=targetdomain.com nebude přiřazena, protože vzor ||*page odpovídá konkrétním doménám, např. example.page.
||*page$domain=targetdomain.com,cookie bude přiřazena, protože pravidlo obsahuje modifikátor $cookie, přestože vzor ||*page může odpovídat konkrétním doménám.
/banner\d+/$domain=targetdomain.com nebude přiřazena, protože obsahuje regulární výraz.
page$domain=targetdomain.com|~example.org nebude přiřazena, protože doména odkazu je výslovně vyloučena.

omezení modifikátoru `$domain`

Omezení

V AdGuardu pro Chrome MV3 nejsou podporovány domény s regexp a any_tld.

Omezení

Safari nepodporuje současné použití povolených a zakázaných domén, takže pravidla jako ||baddomain.com^$domain=example.org|~foo.example.org nebudou v AdGuardu pro iOS a AdGuardu pro Safari fungovat.

Kompatibilita

Pravidla s regulárními výrazy v modifikátoru $domain jsou podporována AdGuardem pro Windows, AdGuardem pro Mac a AdGuardem pro Android s CoreLibs v1.11 nebo novějším a rozšířením prohlížeče AdGuard s TSUrlFilter v3.0.0 nebo novějším.

V AdGuardu pro Windows, Mac a Android s CoreLibs v1.12 nebo novějším může být modifikátor $domain alternativně zapsán jako $from.

`$header`

Modifikátor $header umožňuje porovnat odpověď HTTP se specifickým záhlavím s (volitelně) specifickou hodnotou.

Syntaxe

$header "=" h_name [":" h_value]
h_value = string / regexp

kde:

h_name — povinný název záhlaví HTTP. Je přizpůsoben případ od případu.
h_value — nepovinný výraz odpovídající hodnotě záhlaví HTTP, může to být jeden z následujících výrazů:
- string — posloupnost znaků. Porovnává se s hodnotou záhlaví lexikograficky;
- regexp — regulární výraz, který začíná a končí znakem /. Vzor funguje stejně jako v základních pravidlech pro URL adresy, ale znaky /, $ a , musí být uvozeny pomocí \.

Část modifikátoru ":" h_value lze vynechat. V takovém případě modifikátor odpovídá pouze názvu záhlaví.

Příklady

||example.com^$header=set-cookie:foo blokuje požadavky, jejichž odpovědi mají hlavičku Set-Cookie s hodnotou odpovídající foo.
||example.com^$header=set-cookie blokuje požadavky, jejichž odpovědi mají hlavičku Set-Cookie s libovolnou hodnotou.
@@||example.com^$header=set-cookie:/foo\, bar\$/ odblokuje požadavky, jejichž odpovědi mají hlavičku Set-Cookie s hodnotou odpovídající regulárnímu výrazu foo, bar$.
@@||example.com^$header=set-cookie odblokuje požadavky, jejichž odpovědi mají hlavičku Set-Cookie s libovolnou hodnotou.

omezení modifikátoru `$header`

Omezení

Modifikátor $header lze použít pouze při příjmu záhlaví. Pokud je tedy požadavek zablokován nebo přesměrován v dřívější fázi, nelze modifikátor použít.
V rozšíření prohlížeče Adguard je $header modifikátor kompatibilní pouze s $csp, $removeheader, $important, a $badfilter.

Kompatibilita

Pravidla s modifikátorem $header jsou podporována AdGuardem pro Windows, AdGuardem pro Mac a AdGuardem pro Android s CoreLibs v1.11 nebo novějším a rozšířením prohlížeče AdGuard s TSUrlFilter v3.0.0 nebo novějším.

`$important`

Modifikátor $important použitý na pravidlo zvyšuje jeho prioritu oproti pravidlům bez stejného modifikátoru. Dokonce i přes základní pravidla výjimek.

Další podrobnosti najdete v prioritách pravidel.

Příklady

! pravidlo blokování zablokuje všechny požadavky navzdory pravidlu výjimky
||example.org^$important
@@||example.org^

! pokud má pravidlo výjimky také modifikátor `$important`, bude mít přednost a žádné požadavky nebudou blokovány
||example.org^$important
@@||example.org^$important

`$match-case`

Tento modifikátor definuje pravidlo, které se vztahuje pouze na adresy odpovídající danému případu. Výchozí pravidla nerozlišují velká a malá písmena.

Příklady

*/BannerAd.gif$match-case — toto pravidlo zablokuje http://example.com/BannerAd.gif, ale ne http://example.com/bannerad.gif.

Kompatibilita

Pravidla s $match-case jsou podporována aplikací AdGuard pro iOS a AdGuard pro Safari s SafariConverterLib v2.0.43 nebo novějším.

Všechny ostatní produkty již tento modifikátor podporují.

`$method`

Tento modifikátor omezuje rozsah pravidla na požadavky, které používají zadanou sadu metod HTTP. Negované metody jsou povoleny. Metody musí být zadány malými písmeny, ale při porovnávání se nerozlišují velká a malá písmena. Chcete-li do jednoho pravidla přidat více metod, použijte jako oddělovací znak svislou čáru |.

Příklady

||evil.com^$method=get|head blokuje pouze požadavky GET a HEAD na doméně evil.com.
||evil.com^$method=~post|~put blokuje všechny požadavky na doméně evil.com kromě POST nebo PUT.
@@||evil.com$method=get odblokuje pouze požadavky GET na doméně evil.com.
@@||evil.com$method=~post odblokuje jakékoliv požadavky na doméně evil.com kromě POST.

Omezení

Pravidla se smíšenými negovanými a negovanými hodnotami jsou považována za neplatná. Takže např. pravidlo ||evil.com^$method=get|~head bude ignorováno.

Kompatibilita

Pravidla s modifikátorem $method jsou podporována AdGuardem pro Windows, Mac a Android s CoreLibs v1.12 nebo novější a Rozšířením prohlížeče AdGuard pro Chrome, Firefox a Edge s filtrem TSUrlFilter v2.1.1 nebo novějším.

AdGuard se pokusí zavřít kartu prohlížeče s jakoukoli adresou, která odpovídá pravidlu blokování s tímto modifikátorem. Upozorňujeme, že ne všechny karty lze zavřít.

Příklady

||domain.com^$popup — pokud se pokusíte přejít na http://domain.com/ z libovolné stránky v prohlížeči, nová karta, ve které má být zadaný web otevřen, bude tímto pravidlem zavřena.

omezení modifikátoru `$popup`

Omezení

Modifikátor $popup funguje nejlépe v rozšíření prohlížeče AdGuard pro prohlížeče založené na Chromiu a Firefox.
V pravidlech AdGuard pro Chrome MV3 s modifikátorem $popup by nefungovaly, proto jsme zakázali jejich převod na deklarativní pravidla. Pokusíme se je použít pouze v našem enginu TSUrlFilter a zavírat nové karty programově.
V AdGuardu pro Safari a AdGuardu pro iOS, pravidla $popup stránku jednoduše a okamžitě zablokují.
V AdGuardu pro Windows, Mac a Android nemusí modifikátor $popup v některých případech detekovat vyskakovací okno a nebude zablokováno. Modifikátor $popup použije typ obsahu document se speciálním příznakem, který je předán blokovací stránce. Samotná blokovací stránka může provést některé kontroly a zavřít okno, pokud se skutečně jedná o vyskakovací okno. V opačném případě by se stránka měla načíst. Lze jej kombinovat s dalšími modifikátory typu požadavku, například $third-party, $strict-third-party, $strict-first-party a $important.

Kompatibilita

Pravidla s modifikátorem $popup nejsou Blokátorem obsahu AdGuard podporována.

`$strict-first-party`

Funguje stejně jako modifikátor $~third-party, ale zachází s požadavkem jako s vlastním, pokud má odkazovač a původ naprosto stejný název hostitele.

Příklady

domain.com$strict-first-party' – toto pravidlo platí pouze pro domena.com. Např. požadavek z domain.com na http://domain.com/icon.ico je požadavek vlastní. Požadavek z sub.domain.com na http://domain.com/icon.ico je považován za požadavek třetí strany (na rozdíl od modifikátoru $~third-party).

poznámka

Místo plného názvu modifikátoru můžete použít kratší název (alias): $strict1p.

Kompatibilita

Pravidla s modifikátorem $strict-first-party jsou podporována AdGuardem pro Windows, Mac a Android s CoreLibs v1.16 nebo novější.

`$strict-third-party`

Funguje stejně jako modifikátor $third-party, ale zpracovává požadavky z domény na její subdomény a naopak jako žádosti třetí strany.

Příklady

||domain.com^$strict-thirdparty — toto pravidlo bude použito na všechny domény, kromě domain.com. Příklad požadavku třetí strany: http://sub.domain.com/banner.jpg (na rozdíl od modifikátoru $third-party).

poznámka

Místo plného názvu modifikátoru můžete použít kratší název (alias): $strict3p.

Kompatibilita

Pravidla s modifikátorem $strict-third-party jsou podporována AdGuardem pro Windows, Mac a Android s CoreLibs v1.16 nebo novější.

`$third-party`

Omezení požadavků třetích stran a vlastních požadavků. Požadavek třetí strany je požadavek z externí domény. Např. požadavek na example.org z domain.com je požadavek třetí strany.

poznámka

Aby mohla být žádost třetí strany považována za takovou, měla by splňovat jednu z následujících podmínek:

Její odkazující doména není subdoménou cílové domény nebo naopak. Např. požadavek na subdomain.example.org z example.org není požadavek třetí strany
Její záhlaví Sec-Fetch-Site je nastaveno na cross-site

Příklady

$third-party:

||domain.com^$third-party — toto pravidlo bude použito na všechny domény, kromě domain.com a její subdomény. Příklad požadavku třetí strany: http://example.org/banner.jpg.

Pokud existuje modifikátor $third-party, pravidlo se použije pouze na požadavky, které nejsou od třetích stran. To znamená, že musí být odeslány ze stejné domény.

$~third-party:

||domain.com$~third-party — toto pravidlo se vztahuje výhradně na domain.com. Příklad požadavku která není podán třetí stranou: http://domain.com/icon.ico.

poznámka

Místo plného názvu modifikátoru můžete použít kratší název (alias): $3p.

`$to`

$to omezuje rozsah pravidla na požadavky na zadané domény a jejich subdomény. Chcete-li do jednoho pravidla přidat více domén, použijte jako oddělovací znak |.

Příklady

/ads$to=evil.com|evil.org zablokuje jakýkoliv požadavek na evil.com nebo evil.org a jejich subdomény s cestou, která odpovídá /ads.
/ads$to=~not.evil.com|evil.com zablokuje jakýkoliv požadavek na evil.com a její subdomény s cestou, která odpovídá /ads, kromě požadavků na not.evil.com a její subdomény.
/ads$to=~good.com|~good.org zablokuje všechny požadavky s cestou, která odpovídá /ads, kromě požadavků na good.com nebo good.org a jejich subdomény.

Omezení

$denyallow nelze použít společně s $to. Lze ji vyjádřit pomocí invertovaného $to: $denyallow=a.com|b.com, což je je ekvivalent k $to=~a.com|~b.com.

Kompatibilita

Pravidla s modifikátorem $to jsou podporována AdGuardem pro Windows, AdGuardem pro Mac a AdGuardem pro Android s CoreLibs v1.12 nebo novějším a rozšířením prohlížeče AdGuard s TSUrlFilter v2.1.3 nebo novějším.

Modifikátory typu obsahu

Existuje sada modifikátorů, které lze použít k omezení oblasti použití pravidla na určitý typ obsahu. Tyto modifikátory lze také kombinovat, aby zahrnovaly například obrázky i skripty.

Kompatibilita

V tom, jak AdGuard určuje typ obsahu na různých platformách, je velký rozdíl. U Rozšíření prohlížeče AdGuard je typ obsahu pro každý požadavek poskytován prohlížečem. AdGuard pro Windows, Mac a Android používají následující metodu: nejprve se aplikace pokusí určit typ požadavku podle záhlaví požadavku Sec-Fetch-Dest nebo podle přípony názvu souboru. Pokud není požadavek v této fázi zablokován, určí se typ pomocí záhlaví Content-Type na začátku odpovědi serveru.

Příklady modifikátorů typu obsahu

||example.org^$image — odpovídá všem obrázkům z example.org.
||example.org^$script,stylesheet — odpovídá všem skriptům a stylům z example.org.
||example.org^$~image,~script,~stylesheet — odpovídá všem požadavkům na example.org kromě obrázků, skriptů a stylů.

Modifikátor \ Produkty	Aplikace CoreLibs	AdGuard pro Chromium	AdGuard pro Chrome MV3	AdGuard pro Firefox	AdGuard pro iOS	AdGuard pro Safari	Blokátor obsahu AdGuard
$document	✅	✅	✅	✅	✅	✅	❌
$font	✅	✅	✅	✅	✅	✅	✅
$image	✅	✅	✅	✅	✅	✅	✅
$media	✅	✅	✅	✅	✅	✅	✅
$object	✅	✅	✅	✅	✅	✅	✅
$other	✅	✅	✅	✅	✅	✅	❌
$ping	✅ *[1]	✅	✅	✅	❌	❌	✅
$script	✅	✅	✅	✅	✅	✅	✅
$stylesheet	✅	✅	✅	✅	✅	✅	✅
$subdocument	✅ *[2]	✅	✅	✅	✅	✅	❌
$websocket	✅	✅	✅	✅	✅ *[3]	✅ *[3]	❌
$xmlhttprequest	✅	✅	✅	✅	✅	✅	✅
$webrtc 🚫	❌	❌	❌	❌	❌	❌	❌
$object-subrequest 🚫	❌	❌	❌	❌	❌	❌	❌

poznámka

✅ — plně podporováno
✅ * — podporováno, ale spolehlivost se může lišit nebo se mohou vyskytnout omezení; více informací naleznete v popisu modifikátoru
❌ — nepodporováno
🚫 — odstraněno a již nepodporováno

`$document`

Pravidlo odpovídá požadavkům na dokument hlavního rámce, tj. dokumenty HTML načtené na kartě prohlížeče. Neodpovídá hodnotám iframe, pro ten existuje modifikátor $subdocument.

Ve výchozím nastavení AdGuard neblokuje požadavky, které se načítají na kartě prohlížeče (např. "obcházení hlavního rámce"). Cílem není zabránit načtení stránek, protože uživatel jasně uvedl, že chce, aby se tato stránka načetla. Pokud je však modifikátor $document zadán explicitně, AdGuard tuto logiku nepoužije a zabrání načtení stránky. Místo toho se zobrazí "blokační stránka".

Pokud je tento modifikátor použit s pravidlem výjimky (@@), zcela zakáže blokování na příslušných stránkách. Je to ekvivalentní použití modifikátorů $elemhide, $content, $urlblock, $jsinject, $extension současně.

Příklady

@@||example.com^$document zcela zakáže filtrování všech stránek na example.com a všech subdoménách.
||example.com^$document zablokuje požadavek na dokument HTML na example.com pomocí blokační stránky.
||example.com^$document,redirect=noopframe přesměruje požadavek na HTML dokument na example.com na prázdný HTML dokument.
||example.com^$document,removeparam=test odebere parametr dotazu test z požadavku dokumentu HTML na example.com.
||example.com^$document,replace=/test1/test2/ nahradí test1 za test2 v požadavku na dokument HTML na example.com.

poznámka

Místo plného názvu modifikátoru můžete použít kratší název (alias): $doc.

`$font`

Pravidlo odpovídá požadavkům na písma, např. s příponou .woff.

`$image`

Pravidlo odpovídá požadavkům na obrázky.

`$media`

Pravidlo odpovídá požadavkům na mediální soubory — hudbu a video, např. soubory .mp4.

`$object`

Pravidlo odpovídá prostředkům pluginů prohlížeče, např. Java nebo Flash.

`$other`

Pravidlo se vztahuje na požadavky, jejichž typ nebyl určen nebo neodpovídá výše uvedeným typům.

`$ping`

Pravidlo odpovídá požadavkům vyvolaným buď navigator.sendBeacon(), nebo atributem ping v odkazech.

omezení modifikátoru `$ping`

Omezení

AdGuard pro Windows, Mac a Android často nedokáží přesně detekovat navigator.sendBeacon(). V seznamech filtrů, které mají používat AdGuard produkty založené na knihovně CoreLibs, se nedoporučuje používat $ping.

Kompatibilita

Pravidla s modifikátorem $ping nejsou podporována AdGuardem pro iOS a Safari.

`$script`

Pravidlo odpovídá požadavkům na skripty, např. javascript, vbscript.

`$stylesheet`

Pravidlo odpovídá požadavkům na soubory CSS.

poznámka

Místo plného názvu modifikátoru můžete použít kratší název (alias): $css.

`$subdocument`

Pravidlo odpovídá požadavkům na vestavěné stránky — značky HTML frame a iframe.

Příklady

||example.com^$subdocument blokuje integrované požadavky (frame a iframe) na example.com a všechny její subdomény kdekoli.
||example.com^$subdocument,domain=domain.com blokuje integrované požadavky (frame и iframe) na example.com (a její subdomény) z domain.com a všech jejích subdomén.

poznámka

Místo plného názvu modifikátoru můžete použít kratší název (alias): $frame.

omezení modifikátoru `$subdocument`

Omezení

V AdGuardu pro Windows, Mac a Android jsou subdokumenty detekovány záhlavím Sec-Fetch-Dest, pokud je přítomno. V opačném případě mohou být některé hlavní stránky považovány za dílčí dokumenty.

Kompatibilita

Pravidla s modifikátorem $subdocument nejsou Blokátorem obsahu AdGuard podporována.

`$websocket`

Pravidlo se vztahuje pouze na připojení WebSocket.

omezení modifikátoru `$websocket`

Omezení

AdGuard pro Safari a AdGuard pro iOS je podporován na zařízeních se systémem macOS Monterey (verze 12), respektive iOS 16 a vyšší.

Kompatibilita

Modifikátor $websocket je podporován ve všech produktech AdGuardu kromě Blokátoru obsahu AdGuard.

`$xmlhttprequest`

Pravidlo se vztahuje pouze na požadavky ajax (požadavky odeslané prostřednictvím objektu javascript XMLHttpRequest).

poznámka

Místo plného názvu modifikátoru můžete použít kratší název (alias): $xhr.

Kompatibilita

AdGuard pro Windows, Mac a Android při filtrování starších prohlížečů nedokáže přesně detekovat tento typ a někdy jej detekuje jako $other nebo $script. Tento typ obsahu mohou spolehlivě detekovat pouze při filtrování moderních prohlížečů, které podporují Záhlaví požadavku na načtení metadat.

`$object-subrequest` (odstraněno)

Upozornění na odstranění

Modifikátor $object-subrequest je odstraněn a již není podporován. Pravidla s tímto modifikátorem jsou považována za neplatná. Pravidlo odpovídá požadavkům pluginů prohlížeče (obvykle se jedná o Flash).

`$webrtc` (odstraněno)

Upozornění na odstranění

Tento modifikátor je odstraněn a již není podporován. Pravidla s tímto modifikátorem jsou považována za neplatná. Pokud potřebujete potlačit WebRTC, zvažte použít nowebrtc scriptlet.

Pravidlo se vztahuje pouze na připojení WebRTC.

Příklady

||example.com^$webrtc,domain=example.org blokuje připojení webRTC na example.com z example.org.
@@*$webrtc,domain=example.org zakáže RTC wrapper pro example.org.

Modifikátory pravidel pro výjimky

Pravidla výjimek deaktivují ostatní základní pravidla pro adresy, kterým odpovídají. Začínají značkou @@. Lze na ně aplikovat všechny výše uvedené základní modifikátory a mají také několik speciálních modifikátorů.

Vizuální znázornění

Doporučujeme také seznámit se s přehledem filtrů Adblock Plus, abyste lépe pochopili, jak pravidla výjimek vytvářet.

Modifikátor \ Produkty	Aplikace CoreLibs	AdGuard pro Chromium	AdGuard pro Chrome MV3	AdGuard pro Firefox	AdGuard pro iOS	AdGuard pro Safari	Blokátor obsahu AdGuard
$content	✅	❌	❌	✅	❌	❌	❌
$elemhide	✅	✅	✅	✅	✅	✅	✅
$extension	✅	❌	❌	❌	❌	❌	❌
$jsinject	✅	✅	✅ *[1]	✅	✅	✅	❌
$stealth	✅	✅	❌	✅	❌	❌	❌
$urlblock	✅	✅	❌	✅	✅ *[2]	✅ *[2]	❌
$genericblock	✅	✅	✅	✅	✅ *[3]	✅ *[3]	❌
$generichide	✅	✅	✅	✅	✅	✅	✅
$specifichide	✅	✅	✅	✅	❌	❌	❌

poznámka

✅ — plně podporováno
✅ * — podporováno, ale spolehlivost se může lišit nebo se mohou vyskytnout omezení; více informací naleznete v popisu modifikátoru
❌ — nepodporováno

`$content`

Zakáže filtrování HTML, pravidla $hls, $replace a $jsonprune na stránkách, které odpovídají pravidlu.

Příklady

@@||example.com^$content zakáže všechna pravidla pro úpravu obsahu na stránkách example.com a všech jích subdoménách.

`$elemhide`

Zakáže jakákoliv kosmetická pravidla na stránkách odpovídajících pravidlu.

Příklady

@@||example.com^$elemhide zakáže všechna kosmetická pravidla na example.com a všech subdoménách.

poznámka

Místo plného názvu modifikátoru můžete použít kratší název (alias): $ehide.

`$extension`

Zakáže konkrétní uživatelské skripty nebo všechny uživatelské skripty pro danou doménu.

Syntaxe

$extension[="userscript_name1"[|"userscript_name2"[|"userscript_name3"[...]]]]

userscript_name(i) označuje konkrétní název uživatelského skriptu, který má být modifikátorem zakázán. Modifikátor může obsahovat libovolný počet názvů uživatelských skriptů nebo žádný. V druhém případě modifikátor zakáže všechny uživatelské skripty.

Názvy uživatelských skriptů obvykle obsahují mezery nebo jiné speciální znaky, proto byste měli název uzavřít do uvozovek. Podporovány jsou jednoduché (') i dvojité (") uvozovky ASCII. Více názvů uživatelských skriptů by mělo být odděleno svislou čarou (|). Pokud je však název uživatelského skriptu tvořen jedním slovem bez speciálních znaků, lze jej použít bez uvozovek.

Uživatelské skripty můžete také vyloučit přidáním znaku ~ před hodnotu. V tomto případě nebude uživatelský skript modifikátorem zakázán.

$extension=~"userscript name"

poznámka

Když vyloučíte uživatelský skript, musíte umístit znak ~ mimo uvozovky.

Pokud název uživatelského skriptu obsahuje uvozovky ("), čárky (,) nebo svislé čáry (|), musí být uvozen zpětným lomítkem (\).

$extension="userscript name\, with \"quote\""

Příklady

@@||example.com^$extension="AdGuard Assistant" zakáže uživatelský skript AdGuard asistent na example.com.
@@||example.com^$extension=MyUserscript zakáže uživatelský skript MyUserscript na example.com.
@@||example.com^$extension='AdGuard Assistant'|'AdGuard Popup Blocker' zakáže uživatelské skripty AdGuard asistent a Blokátor vyskakovacích okenAdGuard na example.com.
@@||example.com^$extension=~"AdGuard Assistant" zakáže všechny uživatelské skripty na example.com, kromě AdGuard asistenta.
@@||example.com^$extension=~"AdGuard Assistant"|~"AdGuard Popup Blocker" zakáže všechny uživatelské skripty na example.com, kromě AdGuard asistenta a Blokátor vyskakovacích oken AdGuard.
@@||example.com^$extension žádné uživatelské skripty nebudou fungovat na example.com.
@@||example.com^$extension="AdGuard \"Assistant\"" zakáže uživatelský skript AdGuard "Asistant" na example.com.

Kompatibilita

Pouze AdGuard pro Windows, Mac a Android jsou technicky schopné používat pravidla s modifikátorem $extension.
Pravidla s modifikátorem $extension s konkrétním názvem uživatelského skriptu jsou podporována AdGuardem pro Windows, AdGuardem pro Mac a AdGuardem pro Android s CoreLibs v1.13 nebo novější.

`$jsinject`

Zakazuje přidávání JavaScript kódu na stránku. O pravidlech skripletů a javascriptu si můžete přečíst dále.

Příklady

@@||example.com^$jsinject zakáže javasript na example.com a všech subdoménách.

omezení modifikátoru `$jsinject`

Omezení

Pravidla s modifikátorem $jsinject nelze v AdGuard for Chrome MV3 převést na DNR. Používáme je pouze v enginu TSUrlFilter, abychom zakázali některá kosmetická pravidla.

Kompatibilita

Modifikátor $jsinject není podporován AdGuardem pro Chrome MV3 (zatím) a Blokátorem obsahu AdGuard.

`$stealth`

Zakáže modul Ochrana před sledováním (dříve Režim utajení) pro všechny odpovídající stránky a požadavky.

Syntaxe

$stealth [= opt1 [| opt2 [| opt3 [...]]]]

opt(i) znamená určité možnosti Ochrany před sledováním deaktivované modifikátorem. Modifikátor může obsahovat libovolný počet specifických možností (viz níže) nebo žádnou. V druhém případě modifikátor vypne všechny funkce Ochrany před sledováním.

Seznam dostupných možností modifikátoru:

searchqueries zakáže možnost Skrýt vyhledávací dotazy
donottrack zakáže možnost Požádat webové stránky, aby vás nesledovaly
3p-cookie zakáže možnost Automatické odstranění cookies třetích stran
1p-cookie zakáže možnost Automatické odstranění cookies aktuální stránky
3p-cache zakáže možnost Zakázat mezipaměť pro požadavky třetích stran
3p-auth zakáže možnost Blokovat autorizační hlavičku třetích stran
webrtc zakáže možnost Blokovat WebRTC
push zakáže možnost Blokovat Push API
location zakáže možnost Blokovat lokalizační API
flash zakáže možnost Blokovat Flash
java zakáže možnost Blokovat Java
referrer zakáže možnost Skrýt třetím stranám referenční ID
useragent zakáže možnost Skrýt agenta (identifikaci) Vašeho prohlížeče
ip zakáže možnost Skrýt IP adresu
xclientdata zakáže možnost Odstranit X-Client-Data hlavičku z požadavků HTTP
dpi zakáže možnost Ochrana před DPI

Příklady

@@||example.com^$stealth zakáže Ochranu před sledováním pro požadavky example.com (a subdomény) s výjimkou blokování cookies a skrytí sledovacích parametrů (viz níže).
@@||domain.com^$script,stealth,domain=example.com zakáže Ochranu před sledováním pouze pro požadavky skriptů na domain.com (a subdoménách) na example.com a subdoménách.
@@||example.com^$stealth=3p-cookie|dpi zakáže blokování cookies třetích stran a opatření pro oklamání DPI pro example.com.

poznámka

Blokování cookies a odstranění sledovacích parametrů se provádí pomocí pravidel s modifikátory $cookie, $urltransform a $removeparam. Pravidla výjimek, která obsahují pouze modifikátor $stealth, tyto věci neprovedou. Pokud chcete pro danou doménu zcela zakázat všechny funkce Ochrany před sledováním, musíte uvést všechny tři modifikátory: @@||example.org^$stealth,removeparam,cookie.

Omezení

Možnosti modifikátoru musí být psány malými písmeny, tj. $stealth=DPI budou zamítnuty.
Možnosti modifikátoru nelze negovat, tj. $stealth=~3p-cookie bude zamítnuto.
Rozšíření prohlížeče AdGuard podporuje pouze možnosti searchqueries, donottrack, referrer, xclientdata, 1p-cookie a 3p-cookie.

Kompatibilita

Ochrana před sledováním (dříve Režim utajení) je k dispozici v AdGuardu pro Windows, AdGuardu pro macOS, AdGuardu pro Android a Rozšíření prohlížeče AdGuard pro Firefox a prohlížeče založené na Chromium, kromě AdGuardu pro Chrome Manifest MV3. Všechny ostatní produkty budou ignorovat pravidla s modifikátorem $stealth.
Pravidla s modifikátorem $stealth jsou podporována AdGuardem pro Windows, AdGuardem pro Mac a AdGuardem pro Android s CoreLibs v1.10 nebo novějším a Rozšířením prohlížeče AdGuard s TSUrlFilter v3.0.0 nebo novějším.

`$urlblock`

Zakáže blokování všech požadavků odeslaných ze stránek, které odpovídají pravidlu a zakáže všechna pravidla $cookie.

Příklady

@@||example.com^$urlblock — nebudou blokovány žádné požadavky odeslané z example.com a ze všech subdomén.

omezení modifikátoru `$urlblock`

Omezení

V AdGuardu pro iOS a AdGuardu pro Safari fungují pravidla $urlblock jako $document exclusion — odblokování všeho.

Kompatibilita

Pravidla s modifikátorem $urlblock nejsou podporována Blokátorem obsahu AdGuard, AdGuardem pro Chrome MV3.

Generická pravidla

Než budeme moci přistoupit k dalším modifikátorům, musíme provést definici generických pravidel. Pravidlo je generické, pokud není omezeno na konkrétní domény. Podporován je také zástupný znak *.

Například tato pravidla jsou generická:

###banner
*###banner
#@#.adsblock
*#@#.adsblock
~domain.com###banner
||domain.com^
||domain.com^$domain=~example.com

A tato nejsou:

domain.com###banner
||domain.com^$domain=example.com

`$genericblock`

Zakáže generická základní pravidla na stránkách, které odpovídají pravidlu výjimky.

Příklady

@@||example.com^$genericblock zakáže generická základní pravidla na example.com a všech subdoménách.

omezení modifikátoru `$genericblock`

Omezení

V AdGuardu pro iOS a AdGuardu pro Safari fungují pravidla $genericblock jako $document exclusion — odblokování všeho.

Kompatibilita

Pravidla s modifikátorem $genericblock nejsou podporována Blokátorem obsahu AdGuard, AdGuardem pro Chrome MV3.

`$generichide`

Zakáže všechna generická kosmetická pravidla na stránkách, které odpovídají pravidlu výjimky.

Příklady

@@||example.com^$generichide zakáže všechna kosmetická pravidla na example.com a jejích subdoménách.

poznámka

Místo plného názvu modifikátoru můžete použít kratší název (alias): $ghide.

`specifichide`

Zakáže všechna specifická pravidla pro skrývání prvků a CSS, ale ne obecná pravidla. Má opačný účinek než $generichide.

Příklady

@@||example.org^$specifichide zakáže example.org##.banner, ale ne ##.banner.

poznámka

Místo plného názvu modifikátoru můžete použít kratší název (alias): $shide.

poznámka

Všechna kosmetická pravidla — nejen ta specifická — lze zakázat pomocí modifikátoru $elemhide.

Kompatibilita

Pravidla s modifikátorem $specifichide nejsou AdGuardem pro iOS, Adguardem pro Safari a Blokátorem obsahu AdGuard podporována.

Pokročilé schopnosti

Tyto modifikátory mohou zcela změnit chování základních pravidel.

Modifikátor \ Produkty	Aplikace CoreLibs	AdGuard pro Chromium	AdGuard pro Chrome MV3	AdGuard pro Firefox	AdGuard pro iOS	AdGuard pro Safari	Blokátor obsahu AdGuard
$all	✅	✅	✅ *[1]	✅	✅	✅	❌
$badfilter	✅	✅	✅ *[2]	✅	✅	✅	❌
$cookie	✅	✅	✅ *[3]	✅	❌	❌	❌
$csp	✅	✅	✅	✅	❌	❌	❌
$hls	✅	❌	❌	❌	❌	❌	❌
$inline-font	✅	✅	✅	✅	❌	❌	❌
$inline-script	✅	✅	✅	✅	❌	❌	❌
$jsonprune	✅	❌	❌	❌	❌	❌	❌
$xmlprune	✅	❌	❌	❌	❌	❌	❌
$network	✅	❌	❌	❌	❌	❌	❌
$permissions	✅ *[4]	✅	✅	✅ *[4]	❌	❌	❌
$redirect	✅	✅	✅ *[5]	✅	❌	❌	❌
$redirect-rule	✅	✅	❌	✅	❌	❌	❌
$referrerpolicy	✅	❌	⏳	❌	❌	❌	❌
$removeheader	✅	✅	❌	✅	❌	❌	❌
$removeparam	✅	✅	✅ *[6]	✅	❌	❌	❌
$replace	✅	❌	❌	✅	❌	❌	❌
$urltransform	✅	❌	❌	❌	❌	❌	❌
noop	✅	✅	✅	✅	✅	✅	❌
$empty 👎	✅	✅	✅	✅	❌	❌	❌
$mp4 👎	✅	✅	✅	✅	❌	❌	❌

poznámka

✅ — plně podporováno
✅ * — podporováno, ale spolehlivost se může lišit nebo se mohou vyskytnout omezení; více informací naleznete v popisu modifikátoru
⏳ - funkce, jejíž implementace se plánuje, ale zatím není k dispozici v žádném produktu
❌ — nepodporováno
👎 — zastaralé; stále podporovano, ale v budoucnu bude odstraněno

`$all`

$all modifikátor je složen ze všech modifikátorů typů obsahu a $popup. Např. pravidlo ||example.org^$all se převádí na pravidlo:

||example.org^$document,subdocument,font,image,media,object,other,ping,script,stylesheet,websocket,xmlhttprequest,popup

Omezení

Tento modifikátor nelze použít jako výjimku se znakem @@.

omezení modifikátoru `$all`

Omezení

Vzhledem k tomu, že modifikátor $popup je součástí $all, modifikátor $all není podporován AdGuardem pro Chrome MV3 kcůli $popup omezením modifikátoru.

Kompatibilita

Pravidla s modifikátorem $all nejsou Blokátorem obsahu AdGuard podporována.

`$badfilter`

Pravidla s modifikátorem $badfilter vypnou ostatní základní pravidla, na která se vztahují. To znamená, že text vypnutého pravidla by měl odpovídat textu pravidla $badfilter (bez modifikátoru $badfilter).

Příklady

||example.com$badfilter zakáže ||example.com
||example.com$image,badfilter zakáže ||example.com$image
@@||example.com$badfilter zakáže @@||example.com
||example.com$domain=domain.com,badfilter zakáže ||example.com$domain=domain.com

Pravidla s modifikátorem $badfilter mohou zakázat další základní pravidla pro konkrétní domény, pokud splňují následující podmínky:

Pravidlo má modifikátor $domain
Pravidlo nemá hodnotu modifikátoru negované domény ~ v $domain

V takovém případě pravidlo $badfilter zakáže odpovídající pravidlo pro domény uvedené v pravidlech $badfilter i v základních pravidlech. Upozorňujeme, že logika zástupných znaků TLD funguje i zde.

Příklady

/some$domain=example.com|example.org|example.io je zakázána pro example.com pomocí /some$domain=example.com,badfilter
/some$domain=example.com|example.org|example.io ije zakázána pro example.com a example.org pomocí /some$domain=example.com|example.org,badfilter
/some$domain=example.com|example.org a /some$domain=example.io jsou kompletně zakázány pomocí /some$domain=example.com|example.org|example.io,badfilter
/some$domain=example.com|example.org|example.io je kompletně zakázána pomocí /some$domain=example.*,badfilter
/some$domain=example.* je zakázána pro example.com a example.org pomocí /some$domain=example.com|example.org,badfilter
/some$domain=example.com|example.org|example.io NENÍ zakázána pro example.com pomocí /some$domain=example.com|~example.org,badfilter, protože hodnota modifikátoru $domain obsahuje negovanou doménu

omezení modifikátoru `$badfilter`

Omezení

V AdGuardu pro Chrome MV3 se pravidlo s modifikátorem $badfilter použije v DNR pouze v případě, že úplně zruší zdrojové pravidlo. Nemůžeme ho vypočítat, pokud je zrušeno pouze částečně. Příklady

Kompatibilita

Pravidla s modifikátorem $badfilter nejsou Blokátorem obsahu AdGuard podporována.

Modifikátor $cookie zcela mění chování pravidla. Namísto blokování požadavku, tento modifikátor potlačí AdGuard nebo změní záhlaví Cookie a Set-Cookie.

Vícenásobná pravidla odpovídajících jednomu požadavku

V případě, že jednomu požadavku odpovídá více pravidel $cookie, použijeme každé z nich.

Syntaxe

$cookie [= name[; maxAge = seconds [; sameSite = strategy ]]]

kde:

name — nepovinné, řetězec nebo regulární výraz pro přiřazení názvu cookie.
seconds — počet sekund aktuálního času pro posunutí data vypršení platnosti souboru cookie.
strategy — řetězec pro strategii Same-Site, která se má použít na cookies.

Např.

||example.org^$cookie=NAME;maxAge=3600;sameSite=lax

pokaždé, když AdGuard narazí na cookie s názvem NAME v požadavku na example.org, provede následující kroky:

Nastaví datum vypršení platnosti na aktuální čas plus 3600 sekund
Přiměje cookie použít "laxní" strategii Same-Site.

Uvození speciálních znaků

Pokud je pro porovnání použit regulární výraz name, musí být dva znaky uvozeny: čárka , a znak dolaru $. Každý z nich označte zpětným lomítkem \. Např. uvozená čárka vypadá takto: \,.

Příklady

||example.org^$cookie blokuje všechny soubory cookie nastavené doménou example.org; to je ekvivalent nastavení maxAge=0
$cookie=__cfduid blokuje všude soubory cookie CloudFlare
$cookie=/__utm[a-z]/ blokuje všude soubory cookie Google Analytics
||facebook.com^$third-party,cookie=c_user brání Facebooku ve sledování, i když jste přihlášeni

Existují dva způsoby, jak deaktivovat pravidla $cookie: primární metoda zahrnuje použití výjimky označené @@ — @@||example.org^$cookie. Alternativní metoda využívá výjimku $urlblock (také zahrnutou pod aliasem výjimky $document — $elemhide,jsinject,content,urlblock,extension). Funguje to takto:

@@||example.org^$cookie odblokuje všechny soubory cookie nastavené doménou example.org
@@||example.org^$urlblock odblokuje všechny cookies nastavené doménou example.org a zakáže blokování všech požadavků odeslaných z example.org
@@||example.org^$cookie=concept odblokuje jeden soubor cookie s názvem concept
@@||example.org^$cookie=/^_ga_/ odblokuje každý soubor cookie, který odpovídá regulárnímu výrazu

omezení modifikátoru `$cookie`

Omezení

V AdGuardu pro Chrome MV3 odstraňujeme soubory cookies dvěma způsoby: ze strany content-script (ke které máme přístup) a z onBeforeSendHeaders posluchače. Vzhledem k tomu, že onBeforeSendHeaders a další posluchači již nejsou blokováni, je nemůžeme ve všech případech smazat. Pomocí tohoto testu můžete zkontrolovat, zda pravidlo funguje.

Omezení

Pravidla $cookie podporují tři typy modifikátorů: $domain, $~domain, $important, $third-party, $~third-party, strict-third-party a strict-first-party.

Kompatibilita

Pravidla s modifikátorem $cookie nejsou podporována Blokátorem obsahu AdGuard, AdGuardem pro iOS a AdGuardem pro Safari.

`$csp`

Tento modifikátor zcela mění chování pravidla. Pokud je použitý na pravidlo, pravidlo nezablokuje odpovídající požadavek. Namísto toho se upraví záhlaví odpovědí.

informace

Pro použití tohoto typu pravidel je nutné mít základní znalosti o vrstvě zabezpečení Content Security Policy.

U požadavků, které odpovídají pravidlu $csp, posílíme zásady zabezpečení odezvy posílením zásad zabezpečení obsahu, podobně jako u zásad zabezpečení obsahu modifikátoru obsahu $csp. Pravidla $csp jsou aplikována nezávisle na jakémkoli jiném typu pravidla. Mohou je ovlivnit pouze výjimky na úrovni dokumentu (viz část s příklady), ale žádná jiná základní pravidla.

Vícenásobná pravidla odpovídajících jednomu požadavku

V případě, že jednomu požadavku odpovídá více pravidel $csp, použijeme každé z nich.

Syntaxe

Syntaxe hodnoty $csp je podobná syntaxi záhlaví Content Security Policy.

Hodnota $csp může být v případě pravidel pro výjimky prázdná. Viz níže uvedený oddíl s příklady.

Příklady

||example.org^$csp=frame-src 'none' blokuje všechny obrázky na example.org a jejích subdoménách.
@@||example.org/page/*$csp=frame-src 'none' zakáže všechna pravidla s modifikátorem $csp přesně odpovídajícím příznakem frame-src 'none' na všech stránkách odpovídajících vzoru pravidla. Např. výše uvedené pravidlo.
@@||example.org/page/*$csp zakáže všechna pravidla $csp na všech stránkách odpovídajících vzoru pravidla.
||example.org^$csp=script-src 'self' 'unsafe-eval' http: https: zakáže vložené skripty na všech stránkách odpovídajících vzoru pravidla.
@@||example.org^$document nebo @@||example.org^$urlblock zakáží všechna pravidla $csp na všech stránkách odpovídajících vzoru pravidla.

Omezení

V hodnotě $csp je zakázáno několik znaků: ,, $.
$csp pravidla podporují tři typy modifikátorů: $domain, $important, $subdocument.
Pravidla s direktivami report-* jsou považována za neplatná.

Kompatibilita

Pravidla s modifikátorem $csp nejsou podporována Blokátorem obsahu AdGuard, AdGuardem pro iOS a AdGuardem pro Safari.

`$hls`

Pravidla $hls upravují odpověď na shodný požadavek. Jsou určena k pohodlnému odstraňování segmentů ze seznamů stop HLS playlists (RFC 8216).

poznámka

Slovo "segment" v tomto dokumentu znamená buď "mediální segment" nebo "seznam skladeb" jako součást "hlavního seznamu skladeb": pravidla $hls nerozlišují mezi "hlavním seznamem skladeb" a "mediálním seznamem skladeb".

Syntaxe

||example.org^$hls=urlpattern odstraní segmenty, jejichž adresa URL odpovídá vzoru adresy URL urlpattern. Vzor funguje stejně jako v základních pravidlech pro URL adresy, ale znaky /, $ a , musí být uvozeny pomocí \ uvnitř urlpattern.
||example.org^$hls=/regexp/options odstraní segmenty, kde URL nebo jeden ze znaků (u určitých možností, pokud jsou přítomny) odpovídá regulárnímu výrazu regexp. K dispozici jsou tyto možnosti options:
- t — namísto testování adresy URL segmentu otestujte každý znak segmentu podle regulárního výrazu. Segment se shodným znakem je odstraněn;
- i — regulární výraz nerozlišuje velká a malá písmena.

Znaky /, $ a , musí být uvnitř regexp uvozeny pomocí \.

Výjimky

Základní výjimky URL nesmí zakázat pravidla s modifikátorem $hls. Lze je zakázat, jak je popsáno níže:

@@||example.org^$hls zakáže všechna pravidla $hls pro odpovědi z URL odpovídajících ||example.org^.
@@||example.org^$hls=text zakáže všechna pravidla $hls s hodnotou modifikátoru $hls shodným s text pro odpovědi z URL odpovídajících ||example.org^.

tip

Pravidla $hls lze také zakázat pravidly výjimek $document, $content a $urlblock.

poznámka

Když vícenásobná pravidla $hls odpovídají stejnému požadavku, jejich účinek je kumulativní.

Příklady

||example.org^$hls=\/videoplayback^?*&source=dclk_video_ads odstraní všechny segmenty se shodnou URL.
||example.org^$hls=/\/videoplayback\/?\?.*\&source=dclk_video_ads/i dosáhne víceméně téhož pomocí regulárního výrazu namísto vzoru URL.
||example.org^$hls=/#UPLYNK-SEGMENT:.*\,ad/t odstraní všechny segmenty, které mají odpovídající znak.

Anatomie seznamu stop HLS

Stručné shrnutí specifikace:

Seznam stop HLS je kolekce textových řádků
Řádek může být prázdný, komentář (začíná #), znak (také začíná #, lze jej rozpoznat pouze podle názvu) nebo URL
Řádek URL se nazývá "segment"
Znaky se mohou vztahovat na jeden segment, tj. první řádek adresy URL za znakem, na všechny segmenty následující za znakem až do znaku se stejným názvem nebo na celý seznam skladeb

Některé specifické body týkající se fungování pravidel $hls:

Při odstranění segmentu se odstraní také všechny znaky, které se vztahují pouze k tomuto segmentu
Pokud se znak vztahuje na více segmentů a všechny tyto segmenty jsou odstraněny, je odstraněna i znak
Protože neexistuje způsob, jak rozpoznat různé druhy znaků podle syntaxe, rozpoznáváme všechny znaky uvedené v RFC a některé nestandardní znaky, se kterými jsme se setkali v praxi. Všechny řádky začínající na #. Ty, které nejsou rozpoznány jako znak, jsou předány bez úprav a nejsou porovnávány s pravidly
Značky nebudou přiřazeny, pokud se vztahují na celý seznam stop a k jejich odstranění nelze použít pravidla $hls, protože tyto typy pravidel jsou určeny pro odstraňování segmentů. Pokud víte, co děláte, můžete pomocí pravidel $replace odstranit nebo přepsat pouze jeden znak ze seznamu skladeb

Příklad transformace provedené podle pravidel:

Původní odezva

#EXTM3U
#EXT-X-TARGETDURATION:10
#EXTINF,5
preroll.ts
#UPLYNK-SEGMENT:abc123,ad
#UPLYNK-KEY:aabb1122
#EXT-X-DISCONTINUITY
#EXTINF,10
01.ts
#EXTINF,10
02.ts
#UPLYNK-SEGMENT:abc123,segment
#UPLYNK-KEY:ccdd2233
#EXT-X-DISCONTINUITY
#EXTINF,10
01.ts
#EXTINF,10
02.ts
#EXT-X-ENDLIST

Použitá pravidla

||example.org^$hls=preroll
||example.org^$hls=/#UPLYNK-SEGMENT:.*\,ad/t

Modifikovaná odpověď

#EXTM3U
#EXT-X-TARGETDURATION:10
#UPLYNK-SEGMENT:abc123,segment
#UPLYNK-KEY:ccdd2233
#EXT-X-DISCONTINUITY
#EXTINF,10
01.ts
#EXTINF,10
02.ts
#EXT-X-ENDLIST

Omezení

Pravidla s modifikátorem $hls lze použít pouze v důvěryhodných filtrech.
$hls pravidla jsou kompatibilní pouze s těmito modifikátory: $domain, $third-party, $strict-third-party, $strict-first-party, $app, $important, $match-case a $xmlhttprequest.
$hls pravidla platí pouze pro seznamy stop HLS, což je text kódovaný v UTF-8 začínající řádkem #EXTM3U. Jakákoli jiná odpověď nebude těmito pravidly upravena.
Pravidla $hls neplatí, pokud je velikost původní odpovědi větší než 10 MB.

Kompatibilita

Pravidla s modifikátorem $hls jsou podporována AdGuardem pro Windows, Mac a Android s CoreLibs v1.10 nebo novější.

`$inline-script`

Modifikátor $inline-script je určen k blokování in-line JavaScriptu vloženého do webové stránky pomocí zásad zabezpečení obsahu (CSP). Zlepšuje zabezpečení a soukromí tím, že zabraňuje použití in-line reklam nebo potenciálně škodlivých skriptů. Pravidlo ||example.org^$inline-script se převádí na syntaxi pravidel CSP:

||example.org^$csp=script-src 'self' 'unsafe-eval' http: https: data: blob: mediastream: filesystem:

`$inline-font`

Modifikátor $inline-font je určen k blokování in-line fontů vložených do webové stránky pomocí zásad zabezpečení obsahu (CSP). Zlepšuje zabezpečení a soukromí tím, že zabraňuje použití in-line fontů, které by mohly být použity ke shromažďování dat a čtení digitálních otisků. Pravidlo ||example.org^$inline-font se převádí na syntaxi pravidel CSP:

||example.org^$csp=font-src 'self' 'unsafe-eval' http: https: data: blob: mediastream: filesystem:

`$jsonprune`

Pravidla $jsonprune upravují odpověď na odpovídající požadavek odstraněním položek JSON, které odpovídají upravenému výrazu JSONPath. Nemění odpovědi, které nejsou platnými dokumenty JSON.

V AdGuardu pro Windows, Mac a Android s CoreLibs v1.11 nebo novější, $jsonprune podporuje také úpravu dokumentů JSONP (padded JSON).

Syntaxe

||example.org^$jsonprune=expression odstraní z odpovědi položky, které odpovídají upravenému výrazu JSONPath expression.

Vzhledem ke způsobu zpracování pravidel musí být znaky $ a , uvnitř výrazu uvozeny pomocí \.

Upravená syntaxe JSONPath má oproti původní následující rozdíly:

Výrazy skriptů nejsou podporovány
Podporované výrazy filtrů jsou:
- ?(has <key>) — "true", pokud má aktuální objekt zadaný klíč
- ?(key-eq <key> <value>) — "true", pokud má aktuální objekt zadaný klíč a jeho hodnota se rovná zadané hodnotě
- ?(key-substr <key> <value>) — "true", pokud je zadaná hodnota podřetězcem hodnoty zadaného klíče aktuálního objektu
Mezery mimo řetězce s dvojitými nebo jednoduchými uvozovkami nemají žádný význam
Lze použít řetězce s dvojitými i jednoduchými uvozovkami
Výrazy končící na .. nejsou podporovány
V hranatých závorkách lze zadat vícero dílků pole

Existují různé online nástroje, které usnadňují práci s výrazy JSONPath:

https://www.site24x7.com/tools/jsonpath-finder-validator.html https://jsonpathfinder.com/ https://jsonpath.com/

Mějte však na paměti, že všechny implementace JSONPath mají jedinečné vlastnosti a jsou vzájemně nekompatibilní.

Výjimky

Základní výjimky URL nesmí zakázat pravidla s modifikátorem $jsonprune. Lze je zakázat, jak je popsáno níže:

@@||example.org^$jsonprune zakáže všechna pravidla $jsonprune pro odpovědi z URL odpovídajících ||example.org^.
@@||example.org^$jsonprune=text zakáže všechna pravidla $jsonprune s hodnotou modifikátoru $jsonprune shodným s text pro odpovědi z URL odpovídajících ||example.org^.

Pravidla $jsonprune lze také zakázat pravidly výjimek $document, $content a $urlblock.

poznámka

Když vícenásobná pravidla $jsonprune odpovídají stejnému požadavku, jsou seřazena v lexikografickém pořadí, první pravidlo je aplikováno na původní odpověď a každé ze zbývajících pravidel je aplikováno na výsledek použití předchozího.

Příklady

||example.org^$jsonprune=\$..[one\, "two three"] odstraní všechny výskyty klíčů "one" a "two three" kdekoli v dokumentu JSON.

Vstup

{
    "one": 1,
    "two": {
        "two three": 23,
        "four five": 45
    }
}

Výstup

{
    "two": {
        "four five": 45
    }
}

||example.org^$jsonprune=\$.a[?(has ad_origin)] odstraní všechny potomky a, které mají klíč ad_origin.

Vstup

{
    "a": [
        {
            "ad_origin": "https://example.org",
            "b": 42
        },
        {
            "b": 1234
        }
    ]
}

Výstup

{
    "a": [
        {
            "b": 1234
        }
    ]
}

||example.org^$jsonprune=\$.*.*[?(key-eq 'Some key' 'Some value')] odstraní všechny položky, které jsou na úrovni vnoření 3 a mají vlastnost "Some key" rovnu "Some value".

Vstup

{
    "a": {"b": {"c": {"Some key": "Some value"}, "d": {"Some key": "Other value"}}},
    "e": {"f": [{"Some key": "Some value"}, {"Some key": "Other value"}]}
}

Výstup

{
    "a": {"b": {"d": {"Some key": "Other value"}}},
    "e": {"f": [{"Some key": "Other value"}]}
}

Vnořené výrazy JSONPath

V AdGuardu pro Windows, Mac a Android s CoreLibs v1.11 nebo novější, lze výrazy JSONPath použít jako klíče ve výrazech filtru.

||example.org^$jsonprune=\$.elems[?(má "\$.abc")] odstraní všechny potomky elems, které mají vlastnost volitelnou výrazem JSONPath $.abc.

Vstup

{
    "elems": [
        {
            "a": {"b": {"c": 123}},
            "k": "v"
        },
        {
            "d": {"e": {"f": 123}},
            "k1": "v1"
        }
    ]
}

Výstup

{
    "elems": [
        {
            "d": {"e": {"f": 123}},
            "k1": "v1"
        }
    ]
}

||example.org^$jsonprune=\$.elems[?(key-eq "\$.a.b.c" "abc")] odstraní všechny potomky elems, které mají vlastnost volitelnou pomocí výrazu JSONPath $.a.b.c s hodnotou rovnou "abc".

Vstup

{
    "elems": [
        {
            "a": {"b": {"c": 123}},
        },
        {
            "a": {"b": {"c": "abc"}}
        }
    ]
}

Výstup

{
    "elems": [
        {
            "a": {"b": {"c": 123}}
        }
    ]
}

Omezení

$jsonprune pravidla jsou kompatibilní pouze s těmito modifikátory: $domain, $third-party, $strict-third-party, $strict-first-party, $app, $important, $match-case a $xmlhttprequest.
Pravidla $jsonprune neplatí, pokud je velikost původní odpovědi větší než 10 MB.

Kompatibilita

Pravidla s modifikátorem $jsonprune jsou podporována AdGuardem pro Windows, Mac a Android s CoreLibs v1.10 nebo novější.

`$xmlprune`

Pravidla $xmlprune upravují odpověď na odpovídající požadavek odstraněním položek XML, které odpovídají upravenému výrazuXPath 1.0. Výraz musí vrátit node-set. $xmlprune pravidla neupravují odpovědi, které nejsou dobře formulovanými dokumenty XML.

Syntaxe

||example.org^$xmlprune=expression odstraní z odpovědi položky, které odpovídají výrazu XPath expression.

Vzhledem ke způsobu zpracování pravidel musí být znaky $ a , uvnitř výrazu uvozeny pomocí \.

Výjimky

Základní výjimky URL nesmí zakázat pravidla s modifikátorem $xmlprune. Lze je zakázat, jak je popsáno níže:

@@||example.org^$xmlprune zakáže všechna pravidla $xmlprune pro odpovědi z URL odpovídajících ||example.org^.
@@||example.org^$xmlprune=text zakáže všechna pravidla $xmlprune s hodnotou modifikátoru $xmlprune shodným s text pro odpovědi z URL odpovídajících ||example.org^.

Pravidla $xmlprune lze také zakázat pravidly výjimek $document, $content a $urlblock.

poznámka

Když je více pravidel $xmlprune odpovídá stejnému požadavku, jsou použita v lexikografickém pořadí.

Příklady

||example.org^$xmlprune=/bookstore/book[position() mod 2 = 1] odstraní z knihkupectví knihy s lichými čísly.

Vstup

<?xml version="1.0" encoding="UTF-8"?>

<bookstore>

  <book category="cooking">
    <title lang="en">Everyday Italian</title>
    <author>Giada De Laurentiis</author>
    <year>2005</year>
    <price>30.00</price>
  </book>

  <book category="children">
    <title lang="en">Harry Potter</title>
    <author>J K. Rowling</author>
    <year>2005</year>
    <price>29.99</price>
  </book>

  <book category="web">
    <title lang="en">XQuery Kick Start</title>
    <author>James McGovern</author>
    <author>Per Bothner</author>
    <author>Kurt Cagle</author>
    <author>James Linn</author>
    <author>Vaidyanathan Nagarajan</author>
    <year>2003</year>
    <price>49.99</price>
  </book>

  <book category="web">
    <title lang="en">Learning XML</title>
    <author>Erik T. Ray</author>
    <year>2003</year>
    <price>39.95</price>
  </book>

</bookstore>

Výstup

<?xml version="1.0" encoding="UTF-8"?>

<bookstore>



<book category="children">
  <title lang="en">Harry Potter</title>
  <author>J K. Rowling</author>
  <year>2005</year>
  <price>29.99</price>
</book>



<book category="web">
  <title lang="en">Learning XML</title>
  <author>Erik T. Ray</author>
  <year>2003</year>
  <price>39.95</price>
</book>

</bookstore>

||example.org^$xmlprune=/bookstore/book[year = 2003] odstraní knihy z roku 2003 z knihkupectví.

Vstup

<?xml version="1.0" encoding="UTF-8"?>

<bookstore>

  <book category="cooking">
    <title lang="en">Everyday Italian</title>
    <author>Giada De Laurentiis</author>
    <year>2005</year>
    <price>30.00</price>
  </book>

  <book category="children">
    <title lang="en">Harry Potter</title>
    <author>J K. Rowling</author>
    <year>2005</year>
    <price>29.99</price>
  </book>

  <book category="web">
    <title lang="en">XQuery Kick Start</title>
    <author>James McGovern</author>
    <author>Per Bothner</author>
    <author>Kurt Cagle</author>
    <author>James Linn</author>
    <author>Vaidyanathan Nagarajan</author>
    <year>2003</year>
    <price>49.99</price>
  </book>

  <book category="web">
    <title lang="en">Learning XML</title>
    <author>Erik T. Ray</author>
    <year>2003</year>
    <price>39.95</price>
  </book>

</bookstore>

Výstup

<?xml version="1.0" encoding="UTF-8"?>

<bookstore>

<book category="cooking">
  <title lang="en">Everyday Italian</title>
  <author>Giada De Laurentiis</author>
  <year>2005</year>
  <price>30.00</price>
</book>

<book category="children">
  <title lang="en">Harry Potter</title>
  <author>J K. Rowling</author>
  <year>2005</year>
  <price>29.99</price>
</book>





</bookstore>

||example.org^$xmlprune=//*/@* odstraní všechny atributy ze všech prvků.

Vstup

<?xml version="1.0" encoding="UTF-8"?>

<bookstore location="cy">

  <book category="cooking">
    <title lang="en">Everyday Italian</title>
    <author>Giada De Laurentiis</author>
    <year>2005</year>
    <price>30.00</price>
  </book>

</bookstore>

Výstup

<?xml version="1.0" encoding="UTF-8"?>

<bookstore>

  <book>
    <title>Everyday Italian</title>
    <author>Giada De Laurentiis</author>
    <year>2005</year>
    <price>30.00</price>
  </book>

</bookstore>

Omezení

$xmlprune pravidla jsou kompatibilní pouze s těmito modifikátory: $domain, $third-party, $strict-third-party, $strict-first-party, $app, $important, $match-case a $xmlhttprequest.
Pravidla $xmlprune neplatí, pokud je velikost původní odpovědi větší než 10 MB.

Kompatibilita

Pravidla s modifikátorem $xmlprune jsou podporována AdGuardem pro Windows, Mac a Android s CoreLibs v1.15 nebo novější.

`$network`

Jedná se v podstatě o pravidla typu brány Firewall, která umožňují plně zablokovat nebo odblokovat přístup na zadanou vzdálenou adresu.

Pravidla $network odpovídají pouze IP adresám! Nelze je použít k zablokování nebo odblokování přístupu k doméně.
Chcete-li se shodovat s adresou IPv6, musíte použít sbalenou syntaxi, např. [2001:4860:4860::8888]$network namísto [2001:4860:4860:0:0:0:0:8888]$network.
Pravidlo seznamu povolených $network způsobí, že AdGuard bude obcházet data odpovídajícího koncového bodu, proto nebude provádět žádné další filtrování.
Pokud část IP začíná a končí znakem /, je považována za regulární výraz.

Pro lepší pochopení regulárních výrazů doporučujeme seznámit se s tímto článkem.

Omezení

Modifikátor $network lze v pravidlech použít pouze společně s modifikátory $app a $important, nikoli s žádnými jinými modifikátory.

Příklady

174.129.166.49:3478^$network blokuje přístup k 174.129.166.49:3478 (ale ne k 174.129.166.49:34788).
[2001:4860:4860::8888]:443^$network blokuje přístup k [2001:4860:4860::8888]:443.
174.129.166.49$network blokuje přístup k 174.129.166.49:*.
@@174.129.166.49$network způsobí, že AdGuard bude koncovému bodu předávat data. Žádná jiná pravidla se neuplatňují.
/.+:3[0-9]{4}/$network blokuje přístup k libovolnému portu od 30000 do 39999.
/8.8.8.(:?8|4)/$network blokuje přístup k 8.8.8.8 a 8.8.8.4.

Kompatibilita

Pouze AdGuard pro Windows, Mac a Android jsou technicky schopné používat pravidla s modifikátorem $network.

`$permissions`

Tento modifikátor zcela mění chování pravidla. Pokud je použitý na pravidlo, pravidlo nezablokuje odpovídající požadavek. Namísto toho se upraví záhlaví odpovědí.

informace

Pro použití tohoto typu pravidel je nutné mít základní znalosti o vrstvě zabezpečení Permissions Policy.

U požadavků, které odpovídají pravidlu $permissions, AdGuard posiluje zásady funkcí odpovědi přidáním dalších zásad oprávnění, které se rovnají obsahu modifikátoru $permissions. Pravidla $permissions jsou aplikována nezávisle na jakémkoli jiném typu pravidla. Mohou je ovlivnit pouze výjimky na úrovni dokumentu (viz část s příklady), ale žádná jiná základní pravidla.

Syntaxe

Hodnota syntaxe $permissions je shodná se syntaxí záhlaví Permissions-Policy s následujícími výjimkami:

Čárka, která odděluje více prvků MUSÍ být uvozena – viz příklady níže.
Místo čárky lze pro oddělení funkcí použít znak (|).

Seznam dostupných direktiv je k dispozici zde.

Hodnota $permissions může být v případě pravidel pro výjimky prázdná — viz příklady níže.

Příklady

||example.org^$permissions=autoplay=() zakáže automatické přehrávání médií vyžádaných prostřednictvím rozhraní HTMLMediaElement v rámci example.org.
@@||example.org/page/*$permissions=autoplay=() zakáže všechna pravidla s modifikátorem $permissions přesně odpovídajícím příznakem autoplay=() na všech stránkách odpovídajících vzoru pravidla. Např. výše uvedené pravidlo. Je důležité si uvědomit, že pravidlo výjimky se projeví pouze v případě přesné shody hodnot. Pokud například chcete zakázat pravidlo $permissions=a=()\,b=(), potřebujete pravidlo výjimky @@$permissions=a=()\,b=() a ne @@$permissions=b=()\,a=() ani @@$permissions=b=(), protože b=()\,a=() nebo b=() neodpovídá a=()\,b=().
@@||example.org/page/*$permissions zakáže všechna pravidla $permissions na všech stránkách odpovídajících vzoru pravidla.
$domain=example.org|example.com,permissions=storage-access=()\, camera=() zakáže použití API pro přístup k úložišti pro vyžádání přístupu k nerozděleným souborům cookies a používání vstupních zařízení videa napříč example.org a example.com.
$domain=example.org|example.com,permissions=storage-access=()|camera=() dělá totéž — místo čárky lze k oddělení funkcí použít |.
@@||example.org^$document nebo @@||example.org^$urlblock zakáží všechna pravidla $permission na všech stránkách odpovídajících vzoru pravidla.

poznámka

Pravidla $permissions jsou účinná pouze pro požadavky hlavního rámce a vedlejšího rámce. To znamená, že se použijí při načtení stránky nebo iframe.

poznámka

If there are multiple $permissions rules that match the same request, multiple Permissions-Policy headers will be added to the response for each rule with their $permissions value. So if you have two rules: ||example.org^$permissions=autoplay=() and ||example.org^$permissions=geolocation=()\,camera=() that match the same request, the response will contain two Permissions-Policy headers: autoplay=() and geolocation=()\,camera=().

omezení modifikátoru `$permissions`

Omezení

Firefox ignores the Permissions-Policy header. For more information, see this issue.

Omezení

Zakázané znaky v $permissions hodnotě: $.
$permissions is compatible with a limited set of modifiers: $domain, $important, $subdocument, and content-type modifiers.
Pravidla $permissions, která neobsahují žádné modifikátory typu obsahu , budou odpovídat pouze požadavkům, jejichž typem obsahu je document.

Kompatibilita

Pravidla s modifikátorem $permissions jsou podporována AdGuardem pro Windows, AdGuardem pro Mac a AdGuardem pro Android s CoreLibs v1.11 nebo novějším a rozšířením prohlížeče AdGuard s TSUrlFilter v3.0.0 nebo novějším.
Pipe separator | instead of escaped comma is supported by AdGuard for Windows, AdGuard for Mac, and AdGuard for Android with CoreLibs v1.14 or later, and AdGuard Browser Extension with TSUrlFilter v3.0.0 or later.

`$redirect`

AdGuard je schopen přesměrovat webové požadavky na místní "zdroj".

Syntaxe

AdGuard používá stejnou syntaxi pravidel filtrování jako uBlock Origin. Je také kompatibilní s modifikátorem ABP $rewrite=abp-resource.

$redirect je modifikátor pro základní pravidla filtrování, takže pravidla s tímto modifikátorem podporují všechny ostatní základní modifikátory, jako jsou $domain, $third-party, $script atd.

Hodnota modifikátoru $redirect musí být název zdroje, který bude použit pro přesměrování.

Zakázání pravidel `$redirect`

||example.org/script.js$script,redirect=noopjs — toto pravidlo přesměruje všechny požadavky na example.org/script.js na zdroj s názvem noopjs.
||example.org/test.mp4$media,redirect=noopmp4-1s — toto pravidlo přesměruje všechny požadavky na example.org/test.mp4 na zdroj s názvem noopmp4-1s.
@@||example.org^$redirect zakáže všechna pravidla $redirect pro URL adresy, které odpovídají ||example.org^.
@@||example.org^$redirect=nooptext zakáže všechna pravidla s $redirect=nooptext pro všechny požadavky, které odpovídají ||example.org^.

More information on redirects and their usage is available on GitHub.

Priority pravidel `$redirect`

Pravidla $redirect mají vyšší prioritu než běžná základní pravidla blokování. To znamená, že pokud existuje základní pravidlo blokování, pravidlo $redirect jej přepíše. Allowlist rules with @@ mark have higher priority than $redirect rules. If a basic rule with the $important modifier and the $redirect rule matches the same URL, the latter is overridden unless it's also marked as $important.

In short: $important > @@ > $redirect > basic rules.

Další podrobnosti najdete v prioritách pravidel.

omezení modifikátoru `$redirect`

Omezení

In AdGuard for Chrome MV3 allowlist rules with $redirect are not supported.

Kompatibilita

Rules with $redirect modifier are not supported by AdGuard Content Blocker, AdGuard for iOS, and AdGuard for Safari .
$redirect v uBlock Origin podporuje zadané priority, např. $redirect=noopjs:42. AdGuard to nepodporuje a místo toho pouze zahodí prioritní postfix.

`$redirect-rule`

This is basically an alias to $redirect since it has the same "redirection" values and the logic is almost similar. The difference is that $redirect-rule is applied only in the case when the target request is blocked by a different basic rule.

Další podrobnosti najdete v prioritách pravidel.

Negating $redirect-rule works exactly the same way as for regular $redirect rules. Even more than that, @@||example.org^$redirect will negate both $redirect and $redirect-rule rules.

Příklady

||example.org/script.js
||example.org^$redirect-rule=noopjs

In this case, only requests to example.org/script.js will be "redirected" to noopjs. All other requests to example.org will be kept intact.

Kompatibilita

Rules with $redirect-rule modifier are not supported by AdGuard Content Blocker, AdGuard for iOS, AdGuard for Safari, and AdGuard for Chrome MV3. The discussion about adding support for $redirect-rule rules in Chrome MV3 extensions is currently open.

`$referrerpolicy`

These rules allow overriding of a page's referrer policy. Responses to matching requests will have all of their Referrer-Policy headers replaced with a single header with the value equal to the matching rule's modifier value. If the response carries an HTML document with a <meta name="referrer"... tag, the content attribute of the tag will also be replaced with the modifier value.

An exception rule with a modifier value disables the blocking rule with the same modifier value. An exception rule without a modifier value disables all matched referrer-policy rules.

If a request matches multiple $referrerpolicy rules not disabled by exceptions, only one of them (it is not specified which one) is applied. $referrerpolicy rules without specified content-type modifiers apply to $document and $subdocument content types.

Příklady

||example.com^$referrerpolicy=unsafe-url přepíše zásady odkazování pro example.com pomocí unsafe-url.
@@||example.com^$referrerpolicy=unsafe-url zakáže předchozí pravidlo.
@@||example.com/abcd.html^$referrerpolicy zakáže všechna pravidla $referrerpolicy na example.com/abcd.html.

Kompatibilita

Rules with the $referrerpolicy modifier are supported by AdGuard for Windows, AdGuard for Mac, and AdGuard for Android with CoreLibs v1.12 or later.

`$removeheader`

Rules with $removeheader modifier are intended to remove headers from HTTP requests and responses. The initial motivation for this rule type is to be able to get rid of the Refresh header which is often used to redirect users to an undesirable location. However, this is not the only case where this modifier can be useful.

Just like $csp, $redirect, $removeparam, and $cookie, this modifier exists independently, rules with it do not depend on the regular basic rules, i.e. regular exception or blocking rules will not affect it. By default, it only affects response headers. However, you can also change it to remove headers from HTTP requests as well.

Syntaxe

Basic syntax

||example.org^$removeheader=header-name odstraní odpověď záhlaví s názvem header-name
||example.org^$removeheader=request:header-name odstraní požadavek záhlaví s názvem header-name

$removeheader is case-insensitive, but we suggest always using lower case.

Negating $removeheader

This type of rules works pretty much the same way it works with $csp and $redirect modifiers.

Use @@ to negate $removeheader:

@@||example.org^$removeheader neguje všechna pravidla $removeheader pro URL adresy, které odpovídají ||example.org^.
@@||example.org^$removeheader=header neguje všechna pravidla s $removeheader=header pro jakýkoliv požadavek, který odpovídá ||example.org^.

Pravidla $removeheader lze také zakázat pravidly výjimek $document a $urlblock. Základní pravidla pro výjimky bez modifikátorů to však nedělají. Např. @@||example.com^ nezakáže $removeheader=p pro požadavky na example.com, ale @@||example.com^$urlblock ano.

poznámka

V případě, že jednomu požadavku odpovídá více pravidel $removeheader, použijeme každé z nich.

Příklady

||example.org^$removeheader=refresh odstraní záhlaví Refresh ze všech HTTP odpovědí vrácených doménou example.org a jejími subdoménami.
||example.org^$removeheader=request:x-client-data odstraní záhlaví X-Client-Data ze všech požadavků HTTP.
Další blok pravidel odstraní záhlaví Refresh a Location ze všech odpovědí HTTP vrácených doménou example.org s výjimkou požadavků na example.org/path/*, u kterých nebudou odstraněny žádné záhlaví:
```
||example.org^$removeheader=refresh
||example.org^$removeheader=location
@@||example.org/path/$removeheader
```

Omezení

Tento typ pravidel lze použít pouze v důvěryhodných filtrech.

Aby nedošlo k narušení bezpečnosti, nelze z níže uvedeného seznamu odstranit záhlaví $removeheader:
- access-control-allow-origin
- access-control-allow-credentials
- access-control-allow-headers
- access-control-allow-methods
- access-control-expose-headers
- access-control-max-age
- access-control-request-headers
- access-control-request-method
- origin
- timing-allow-origin
- allow
- cross-origin-embedder-policy
- cross-origin-opener-policy
- cross-origin-resource-policy
- content-security-policy
- content-security-policy-report-only
- expect-ct
- feature-policy
- origin-isolation
- strict-transport-security
- upgrade-insecure-requests
- x-content-type-options
- x-download-options
- x-frame-options
- x-permitted-cross-domain-policies
- x-powered-by
- x-xss-protection
- public-key-pins
- public-key-pins-report-only
- sec-websocket-key
- sec-websocket-extensions
- sec-websocket-accept
- sec-websocket-protocol
- sec-websocket-version
- p3p
- sec-fetch-mode
- sec-fetch-dest
- sec-fetch-site
- sec-fetch-user
- referrer-policy
- content-type
- content-length
- accept
- accept-encoding
- host
- connection
- transfer-encoding
- upgrade
$removeheader pravidla jsou kompatibilní pouze s těmito modifikátory: $domain, $third-party, $strict-third-party, $strict-first-party, $app, $important, $match-case a modifikátory typu obsahu jako $script a $stylesheet. Pravidla s jinými modifikátory jsou považována za neplatná a budou vyřazena.

Kompatibilita

Pravidla s modifikátorem $removeheader podporuje AdGuard pro Windows, Mac, Android a Rozšíření prohlížeče AdGuard pro Chrome, Firefox a Edge.

`$removeparam`

poznámka

$queryprune je alias $removeparam. Protože je $queryprune zastaralý, nepoužívejte jej a místo něj použijte $removeparam.

Pravidla s modifikátorem $removeparam jsou určena k odstranění parametrů dotazu z požadavků adres URL. Please note that such rules are only applied to GET, HEAD, OPTIONS, and sometimes POST requests.

Syntaxe

Základní syntaxe

$removeparam=param odstraní parametr dotazu s názvem param z URL libovolného požadavku, např. požadavek na http://example.com/page?param=1&another=2 bude transformován na http://example.com/page?another=2.

Regulární výrazy

Regulární výrazy můžete použít také k porovnání parametrů dotazu a/nebo jejich hodnot:

$removeparam=/regexp/[options] — odstraní parametry dotazu, které odpovídají regulárnímu výrazu regexp z adres URL jakéhokoli požadavku. Na rozdíl od základní syntaxe to znamená "odebrat parametry dotazu normalizované na řetězec name=value, který odpovídá regulárnímu výrazu regexp ". [options] zde je seznam možností regulárních výrazů. V současné době je jedinou podporovanou možností i, díky čemuž se nerozlišují malá a velká písmena.

Uvození speciálních znaků

Nezapomeňte v regulárních výrazech uvodit speciální znaky jako ,, / a $. Pro tento účel použijte znak \. Např. uvozená čárka by měla vypadat takto: \,.

poznámka

Pravidla typu regexp se zaměřují na název i hodnotu parametru. Aby se minimalizovala možnost chyb, je bezpečnější začínat každý regexp znakem /^, pokud se nezaměřujete výslovně na hodnoty parametrů.

Pokusíme se automaticky detekovat a ignorovat neuvozený znak $ pomocí jednoduchého pravidla — nejedná se o oddělovač možností, pokud jsou všechny tři hodnoty pravdivé:

Vypadá to jako $/
Nalevo od něj je další znak lomítka /
Nalevo od tohoto znaku lomítka je další znak dolaru bez uvození $

Odebrat všechny parametry dotazu

Chcete-li odstranit všechny parametry dotazu, zadejte samostatně $removeparam:

||example.org^$removeparam — odstraní všechny parametry dotazu z adres URL odpovídajících ||example.org^.

Inverze

Pro použití inverze použijte ~:

$removeparam=~param — odstraní všechny parametry dotazu s názvem odlišným od param.
$removeparam=~/regexp/ — odstraní všechny parametry dotazu, které neodpovídají regulárnímu výrazu regexp.

Negace $removeparam

Tento druh pravidel funguje v podstatě stejně jako u modifikátorů $csp a $redirect.

K negaci $removeparam použijte @@:

@@||example.org^$removeparam neguje všechna pravidla $removeparam pro URL adresy, které odpovídají ||example.org^.
@@||example.org^$removeparam=param neguje všechna pravidla s $removeparam=param pro jakýkoliv požadavek, který odpovídá ||example.org^.
@@||example.org^$removeparam=/regexp/ neguje všechna pravidla s $removeparam=/regexp/ pro jakýkoliv požadavek, který odpovídá ||example.org^.

Vícenásobná pravidla odpovídajících jednomu požadavku

V případě, že jednomu požadavku odpovídá více pravidel $removeparam, bude každé z nich použito jedno po druhém.

Příklady

$removeparam=/^(utm_source|utm_medium|utm_term)=/
$removeparam=/^(utm_content|utm_campaign|utm_referrer)=/
@@||example.com^$removeparam

S těmito pravidly bude z jakéhokoli požadavku odstraněno UTM parametrů, kromě toho, že požadavky na example.com nebudou odstraněny vůbec, např. http://google.com/page?utm_source=s&utm_referrer= fb.com&utm_content=img bude transformováno na http://google.com/page, ale http://example.com/page?utm_source=s&utm_referrer=fb.com&utm_content=img nebude ovlivněno pravidlem blokování.

$removeparam=utm_source odstraní parametr dotazu utm_source ze všech požadavků.
$removeparam=/utm_.*/ odstraní všechny parametry utm_* query z URL libovolného požadavku, např. požadavek na http://example.com/page?utm_source=test bude transformován na http://example.com/page.
$removeparam=/^utm_source=campaign$/ odstraní parametr dotazu utm_source s hodnotou rovnou campaign. Nemá vliv na ostatní parametry utm_source.

Negace pravidla $removeparam a jeho nahrazení jiným pravidlem

$removeparam=/^(gclid|yclid|fbclid)=/
@@||example.com^$removeparam=/^(gclid|yclid|fbclid)=/
||example.com^$removeparam=/^(yclid|fbclid)=/

Díky těmto pravidlům budou ze všech požadavků odstraněny identifikátory kliknutí Google, Yandex a Facebook. Existuje jedna výjimka: Z požadavků na example.com nebude odstraněno Google Click ID (gclid).

Negace pro všechny parametry $removeparam

$removeparam=/^(utm_source|utm_medium|utm_term)=/
$removeparam=/^(utm_content|utm_campaign|utm_referrer)=/
@@||example.com^$removeparam

Díky těmto pravidlům budou zadané parametry UTM odstraněny ze všech požadavků s výjimkou požadavků na example.org.

Pravidla $removeparam lze také zakázat pravidly výjimek $document a $urlblock. Základní pravidla pro výjimky bez modifikátorů to však nedělají. Např. @@||example.com^ nezakáže $removeparam=p pro požadavky na example.com, ale @@||example.com^$urlblock ano.

omezení modifikátoru `$removeparam`

Omezení

AdGuard for Chrome MV3 has some limitations:

Regular expressions, negation and allowlist rules are not supported.

Group of similar $removeparam rules will be combined into one. Příklad:

||testcases.adguard.com$xmlhttprequest,removeparam=p1case1
||testcases.adguard.com$xmlhttprequest,removeparam=p2case1
||testcases.adguard.com$xmlhttprequest,removeparam=P3Case1
$xmlhttprequest,removeparam=p1case2

je převedeno na

[
{
  "id": 1,
  "action": {
  "type": "redirect",
  "redirect": {
    "transform": {
    "queryTransform": {
      "removeParams": [
      "p1case1",
      "p2case1",
      "P3Case1"
      ]
    }
    }
  }
  },
  "condition": {
  "urlFilter": "||testcases.adguard.com",
  "resourceTypes": [
    "xmlhttprequest"
  ],
  "isUrlFilterCaseSensitive": false
  }
},
{
  "id": 4,
  "action": {
  "type": "redirect",
  "redirect": {
    "transform": {
    "queryTransform": {
      "removeParams": [
      "p1case2"
      ]
    }
    }
  }
  },
  "condition": {
  "resourceTypes": [
    "xmlhttprequest"
  ],
  "isUrlFilterCaseSensitive": false
  }
}
]

Omezení

Pravidla s modifikátorem $removeparam lze použít pouze v důvěryhodných filtrech.
$removeparam rules are compatible with basic modifiers, content-type modifiers, and with the $important and $app modifiers. Pravidla s jinými modifikátory jsou považována za neplatná a budou vyřazena.
$removeparam rules without content type modifiers will only match requests where the content type is document.

Kompatibilita

Rules with $removeparam modifier are supported by AdGuard for Windows, AdGuard for Mac, and AdGuard for Android with CoreLibs v1.7 or later, and AdGuard Browser Extension v3.6 or later.
$removeparam syntax for regular expressions is supported AdGuard for Windows, AdGuard for Mac, and AdGuard for Android with CoreLibs v1.8 or later, and AdGuard Browser Extension v4.0 or later.
POST request types are supported only by AdGuard for Windows, Mac, and Android with CoreLibs v1.10 or later, and AdGuard Browser Extension with TSWebExtension v0.4.6 or later.

`$replace`

Tento modifikátor zcela mění chování pravidla. If it is applied, the rule will not block the request. The response is going to be modified instead.

You will need some knowledge of regular expressions to use $replace modifier.

Funkce

$replace rules apply to any text response, but will not apply to binary (media, image, object, etc.).
$replace rules do not apply if the size of the original response is more than 10 MB.
$replace rules have a higher priority than other basic rules (including exception rules). So if a request natches two different rules, one of which has the $replace modifier, this rule will be applied.
Document-level exception rules with $content or $document modifiers do disable $replace rules for requests matching them.
Other document-level exception rules ($generichide, $elemhide or $jsinject modifiers) are applied alongside $replace rules. It means that you can modify the page content with a $replace rule and disable cosmetic rules there at the same time.

$replace value can be empty in the case of exception rules. See examples section for further information.

Vícenásobná pravidla odpovídajících jednomu požadavku

In case if multiple $replace rules match a single request, we will apply each of them. The order is defined alphabetically.

Syntaxe

In general, $replace syntax is similar to replacement with regular expressions in Perl.

replace = "/" regexp "/" replacement "/" modifiers

regexp — regulární výraz.
replacement — řetězec, který bude použit k nahrazení řetězce odpovídajícího regexp.
modifiers — příznaky regulárního výrazu. Například i — necitlivé vyhledávání nebo s — jednořádkový režim.

V hodnotě $replace musí být dva znaky uvozeny: čárka , a znak dolaru $. Použijte pro to zpětné lomítko \. Např. uvozená čárka vypadá takto: \,.

Příklady

||example.org^$replace=/(<VAST[\s\S]*?>)[\s\S]*<\/VAST>/\$1<\/VAST>/i

Toto pravidlo má tři části:

regexp — (<VAST(.|\s)*?>)(.|\s)*<\/VAST>;
replacement — \$1<\/VAST> kde $ je uvozeno;
modifiers — i pro necitlivé vyhledávání.

Jak toto pravidlo funguje, se můžete podívat zde: http://regexr.com/3cesk

Vícenásobná pravidla $replace

||example.org^$replace=/X/Y/
||example.org^$replace=/Z/Y/
@@||example.org/page/*$replace=/Z/Y/

Jak pravidlo 1, tak pravidlo 2 se použijí na všechny požadavky odeslané na example.org.
Pravidlo 2 je zakázáno pro požadavky odpovídající na ||example.org/page/, ale pravidlo 1 stále funguje!

Zakázání pravidel $replace

@@||example.org^$replace zakáže všechna pravidla $replace odpovídající na ||example.org^.
@@||example.org^$document nebo @@||example.org^$content zakáže všechna pravidla $replace pocházející ze stránek example.org včetně stránky samotné.

Omezení

Pravidla s modifikátorem $replace lze použít pouze v důvěryhodných filtrech.

Kompatibilita

Pravidla s modifikátorem $replace podporuje AdGuard pro Windows, Mac, Android a Rozšíření prohlížeče AdGuard pro Chrome, Firefox a Edge. Taková pravidla v rozšířeních pro jiné prohlížeče nefungují, protože nemohou měnit obsah na úrovni sítě.

`$urltransform`

The $urltransform rules allow you to modify the request URL by replacing text matched by a regular expression.

Funkce

$urltransform rules normally only apply to the path and query parts of the URL, see below for one exception.
$urltransform nebude použito, pokud je původní URL blokována jinými pravidly.
$urltransform se použije před pravidly $removeparam.

Hodnota $urltransform může být pro pravidla výjimek prázdná.

Vícenásobná pravidla odpovídajících jednomu požadavku

Pokud jednomu požadavku odpovídá více pravidel $urltransform, použijeme každé z nich. Pořadí je stanoveno abecedně.

Syntaxe

$urltransform syntaxe je podobná nahrazování regulárními výrazy v Perl.

urltransform = "/" regexp "/" replacement "/" modifiers

regexp — regulární výraz.
replacement — řetězec, který bude použit k nahrazení řetězce odpovídajícího regexp.
modifiers — příznaky regulárního výrazu. Například i — necitlivé vyhledávání nebo s — jednořádkový režim.

V hodnotě $urltransform musí být dva znaky uvozeny: čárka , a znak dolaru $. K tomu použijte znak zpětného lomítka \. Např. uvozená čárka vypadá takto: \,.

Changing the origin

Kompatibilita

This section only applies to AdGuard for Windows, AdGuard for Mac, and AdGuard for Android with CoreLibs v1.17 or later.

As stated above, normally $urltransform rules are only allowed to change the path and query parts of the URL. However, if the rule's regexp begins with the string ^http, then the full URL is searched and can be modified by the rule. Such a rule will not be applied if the URL transformation can not be achieved via an HTTP redirect (for example, if the request's method is POST).

Příklady

||example.org^$urltransform=/(pref\/).*\/(suf)/\$1\$2/i

Toto pravidlo má tři části:

regexp — (pref\/).*\/(suf);
replacement — \$1\$2 where $ is escaped;
modifiers — i pro necitlivé vyhledávání.

Multiple $urltransform rules

||example.org^$urltransform=/X/Y/
||example.org^$urltransform=/Z/Y/
@@||example.org/page/*$urltransform=/Z/Y/

Jak pravidlo 1, tak pravidlo 2 se použijí na všechny požadavky odeslané na example.org.
Pravidlo 2 je zakázáno pro požadavky odpovídající na ||example.org/page/, ale pravidlo 1 stále funguje!

Re-matching rules after transforming the URL

After applying all matching $urltransform rules, the transformed request will be matched against all other rules:

E.g., with the following rules:

||example.com^$urltransform=/firstpath/secondpath/
||example.com/secondpath^

the request to https://example.com/firstpath will be blocked.

Disabling $urltransform rules

@@||example.org^$urltransform will disable all $urltransform rules matching ||example.org^.
@@||example.org^$urltransform=/Z/Y/ will disable the rule with $urltransform=/Z/Y/ for any request matching ||example.org^.

$urltransform rules can also be disabled by $document and $urlblock exception rules. Základní pravidla pro výjimky bez modifikátorů to však nedělají. For example, @@||example.com^ will not disable $urltransform=/X/Y/ for requests to example.com, but @@||example.com^$urlblock will.

Omezení

Rules with the $urltransform modifier can only be used in trusted filters.

Kompatibilita

Rules with the $urltransform modifier are supported by AdGuard for Windows, AdGuard for Mac, and AdGuard for Android with CoreLibs v1.15 or later.

`noop`

noop modifier does nothing and can be used solely to increase rules' readability. It consists of a sequence of underscore characters (_) of arbitrary length and can appear in a rule as often as needed.

Příklady

||example.com$_,removeparam=/^ss\\$/,_,image
||example.com$replace=/bad/good/,___,~third-party

Kompatibilita

Rules with noop modifier are not supported by AdGuard Content Blocker.

`$empty` (zastaralé)

Deprecation notice

This modifier is deprecated in favor of the $redirect modifier. Rules with $empty are still supported and being converted into $redirect=nooptext now but the support shall be removed in the future.

Usually, blocked requests look like a server error to browser. If you use $empty modifier, AdGuard will emulate a blank response from the server with200 OK status.

Příklady

||example.org^$empty returns an empty response to all requests to example.org and all subdomains.

Kompatibilita

Rules with $empty modifier are not supported by AdGuard Content Blocker, AdGuard for iOS, and AdGuard for Safari.

`$mp4` (zastaralé)

Deprecation notice

This modifier is deprecated in favor of the $redirect modifier. Rules with $mp4 are still supported and being converted into $redirect=noopmp4-1s,media now but the support shall be removed in the future.

As a response to blocked request AdGuard returns a short video placeholder.

Příklady

||example.com/videos/$mp4 blocks all video downloads from ||example.com/videos/* and changes the response to a video placeholder.

Kompatibilita

Rules with $mp4 modifier are not supported by AdGuard Content Blocker, AdGuard for iOS, and AdGuard for Safari.

Priority pravidel

Each rule has its own priority, which is necessary when several rules match the request and the filtering engine needs to select one of them. Priority is measured by a positive integer.

Collisions

When two rules with the same priority match the same request, the filter engine implementation determines which one is chosen.

informace

The concept of rule priorities becomes increasingly important in light of Manifest V3, as the existing rules need to be converted to declarativeNetRequest rules.

Výpočet priority

To calculate priority, we've categorized modifiers into different groups. These groups are ranked based on their priority, from lowest to highest. A modifier that significantly narrows the scope of a rule adds more weight to its total priority. Conversely, if a rule applies to a broader range of requests, its priority decreases.

It's worth noting that there are cases where a single-parameter modifier has a higher priority than multi-parameter ones. For instance, in the case of $domain=example.com|example.org, a rule that includes two domains has a slightly broader effective area than a rule with one specified domain, therefore its priority is lower.

The base priority of any rule is 1. If the calculated priority is a floating-point number, it will be rounded up to the smallest integer greater than or equal to the calculated priority.

Kompatibilita

The concept of priority has been introduced in TSUrlFilter v2.1.0 and CoreLibs v1.13. Before that AdGuard didn't have any special priority computation algorithm and collisions handling could be different depending on AdGuard product and version.
AdGuard for iOS, Safari, and AdGuard Content Blocker rely on the browsers implementation and they cannot follow the rules specified here.

poznámka

Modifier aliases (1p, 3p, etc.) are not included in these categories, however, they are utilized within the engine to compute the rule priority.

Základní modifikátory, přítomnost každého z nich přidává 1 k prioritě

$app with negated applications using ~,
$denyallow,
$domain with negated domains using ~,
$match-case,
$method with negated methods using ~,
$strict-first-party,
$strict-third-party,
$third-party,
$to,
restricted content-types with ~.

When dealing with a negated domain, app, method, or content-type, we add 1 point for the existence of the modifier itself, regardless of the quantity of negated domains or content-types. This is because the rule's scope is already infinitely broad. Put simply, by prohibiting multiple domains, content-types, methods or apps, the scope of the rule becomes only minimally smaller.

Definované modifikátory typu obsahu, definované metody, definovaná záhlaví, $all, $popup, specifické výjimky

All valid content types:

$document,
$font,
$image,
$media,
$object,
$other,
$ping,
$script,
$stylesheet,
$subdocument,
$websocket,
$xmlhttprequest;

This also includes rules that implicitly add all content types:

$all;

Or rules that implicitly add the modifier $document:

$popup;

Or some specific exceptions that implicitly add $document,subdocument:

$content,
$elemhide,
$extension,
$genericblock,
$generichide,
$jsinject,
$specifichide,
$urlblock;

Or allowed methods via $method.

Or rules with $header.

The presence of any content-type modifiers adds (50 + 50 / N), where N is the number of modifiers present, for example: ||example.com^$image,script will add 50 + 50 / 2 = 50 + 25 = 75 to the total weight of the rule.

The $all also belongs to this category, because it implicitly adds all content type modifiers, e.g., $document,subdocument,image,script,media,<etc> + $popup.

The $popup also belongs to this category, because it implicitly adds the modifier $document. Similarly, specific exceptions add $document,subdocument.

If there is a $method modifier in the rule with allowed methods it adds (50 + 50 / N), where N is the number of methods allowed, for example: ||example.com^$method=GET|POST|PUT will add 50 + 50 / 3 = 50 + 16.6 = 67 to the total weight of the rule.

If there is a $header modifier in the rule, it adds 50.

`$domain` nebo `$app` s povolenými doménami nebo aplikacemi

Specified domains through $domain or specified applications through $app add 100 + 100 / N, where N is the number of modifier values for example: ||example.com^$domain=example.com|example.org|example.net will add 100 + 100 / 3 = 134.3 = 135 or ||example.com^$app=org.example.app1|org.example.app2 will add 100 + 100 / 2 = 151 or ||example.com^$domain=example.com,app=org.example.app1|org.example.app2 will add 100 + 100/1 ($domain part) and 100 + 100/2 ($app part), totaling 350.

Modifier values that are regexps or tld will be interpreted as normal entries of the form example.com and counted one by one, for example: ||example.com^$domain=example.* will add 100 + 100 / 1 = 200 or ||example.com^$domain=example.*|adguard.* will add 100 + 100 / 2 = 150.

Pravidla `$redirect`

$redirect,
$redirect-rule.

Each of which adds 10^3 to rule priority.

Specifické výjimky

$content,
$elemhide,
$extension,
$genericblock,
$generichide,
$jsinject,
$specifichide,
$urlblock;

Each of which adds 10^4 to the priority.

As well as exception with $document modifier: because it's an alias for $elemhide,content,jsinject,urlblock,extension. It will add 10^4 for each modifier from the top list, 10^4 * 5 in total.

In addition, each of these exceptions implicitly adds the two allowed content-type modifiers $document,subdocument.

Pravidla seznamu povolených

Modifier @@ adds 10^5 to rule priority.

Pravidla `$important`

Modifier $important adds 10^6 to rule priority.

Pravidla, pro která není stanovena váha priority

Other modifiers, which are supposed to perform additional post- or pre-processing of requests, do not add anything to the rules priority.

poznámka

The $replace modifier takes precedence over all blocking rules of categories 1-3, as well as exception rules from categories 3-5, except $content, because an exception with the $content modifier overrides all $replace rules.

Příklady

||example.com^
Weight of the rule without modifiers: 1.
||example.com^$match-case
Rule weight: base weight + weight of the modifier from category 1: 1 + 1 = 2.
||example.org^$removeparam=p
Rule weight: base weight + 0, since $removeparam is not involved in the priority calculation: 1 + 0 = 1.
||example.org^$document,redirect=nooptext
Rule weight: base weight + allowed content type, category 3 + $redirect from category 6: 1 + (100 + 100 / 1) + 1000 = 1201.
@@||example.org^$removeparam=p,document
Rule weight: base weight + allowlist rule, category 5 + 0 because $removeparam is not involved in the priority calculation + allowed content type, category 2: 1 + 10000 + 0 + (50 + 50 / 1) = 10101.
@@||example.com/ad/*$domain=example.org|example.net,important
Rule weight: base weight + allowlist rule, category 5 + important rule, category 7 + allowed domains, category 3: 1 + 10000 + 1000000 + (100 + 100 / 2) = 1010152.
@@||example.org^$document without additional modifiers is an alias for @@||example.com^$elemhide,content,jsinject,urlblock,extension
Rule weight: base weight + specific exceptions, category 4 + two allowed content types (document and subdocument), category 2: 1 + 10000 * 4 + (50 + 50 / 2) = 40076.
*$script,domain=a.com,denyallow=x.com|y.com
Rule weight: base weight + allowed content type, category 2 + allowed domain, category 3 + denyallow, category 1: 1 + (50 + 50/1) + (100 + 100 / 1) + 1 = 303.
||example.com^$all — alias to ||example.com^$document,subdocument,image,script,media,etc. + $popup
Rule weight: base weight + popup (category 1) + allowed content types (category 2): 1 + 1 + (50 + 50/12) = 55.

Ostatní pravidla

However, basic rules may not be enough to block ads. Sometimes you need to hide an element or change part of the HTML code of a web page without breaking anything. The rules described in this section are created specifically for this purpose.

Kategorie \ Produkty	Aplikace CoreLibs	AdGuard pro Chromium	AdGuard pro Chrome MV3	AdGuard pro Firefox	AdGuard pro iOS	AdGuard pro Safari	Blokátor obsahu AdGuard
Skrytí prvků	✅	✅	✅	✅	✅	✅	✅
Pravidla CSS	✅	✅	✅	✅	✅	✅	❌
Rozšířené CSS	✅	✅	✅	✅	✅	✅	❌
HTML filtrování	✅	❌	❌	✅	❌	❌	❌
JavaScript	✅	✅	✅	✅	✅	✅	❌
Scriptlety	✅	✅	✅	✅	✅	✅	❌

poznámka

✅ — plně podporováno
❌ — nepodporováno

Kosmetická pravidla

informace

Work with non-basic rules requires the basic knowledge of HTML and CSS. So, if you want to learn how to make such rules, we recommend to get acquainted with this documentation.

Pravidla pro skrytí prvků

Element hiding rules are used to hide the elements of web pages. It is similar to applying { display: none; } style to selected element.

Element hiding rules may operate differently depending on the platform.

Syntaxe

   rule = [domains] "##" selector
domains = [domain0, domain1[, ...[, domainN]]]

selector — CSS selector, defines the elements to be hidden.
domains — domain restriction for the rule.

If you want to limit the rule application area to certain domains, just enter them separated with commas. For example: example.org,example.com##selector.

This rule will be also applied to all subdomains of example.org and example.com.

Pokud chcete, aby se pravidlo nevztahovalo na určité domény, začněte název domény znakem ~. For example: ~example.org##selector.

You can use both approaches in a single rule. For example, example.org,~subdomain.example.org##domain will work for example.org and all subdomains, except subdomain.example.org.

poznámka

Element hiding rules are not dependent on each other. If there is a rule example.org##selector in the filter and you add ~example.org##selector both rules will be applied independently.

Příklady

example.com##div.textad — hides a div with the class textad at example.com and all subdomains.
example.com,example.org###adblock — hides an element with attribute id equals adblock at example.com, example.org and all subdomains.
~example.com##.textad — hides an element with the class textad at all domains, except example.com and its subdomains.

Omezení

Safari does not support both allowed and disallowed domains. So the rules like example.org,~foo.example.org##.textad are invalid in AdGuard for Safari.

Výjimky

Exceptions can disable some rules on particular domains. They are very similar to usual exception rules, but instead of ## you have to use #@#.

For example, there is a rule in filter:

##.textad

If you want to disable it for example.com, you can create an exception rule:

example.com#@#.textad

Sometimes, it may be necessary to disable all restriction rules. For example, to conduct tests. To do this, use the exclusion rule without specifying a domain. It will completely disable matching CSS elemhide rule on ALL domains:

#@#.textad

The same can be achieved by adding this rule:

*#@#.textad

We recommend to use this kind of exceptions only if it is not possible to change the hiding rule itself. In other cases it is better to change the original rule, using domain restrictions.

Pravidla CSS

Sometimes, simple hiding of an element is not enough to deal with advertising. For example, blocking an advertising element can just break the page layout. In this case AdGuard can use rules that are much more flexible than hiding rules. With these rules you can basically add any CSS styles to the page.

Syntaxe

   rule = [domains] "#$#" selector "{" style "}"
domains = [domain0, domain1[, ...[, domainN]]]

selector — CSS selector, that defines the elements we want to apply the style to.
domains — domain restriction for the rule. Same principles as in element hiding rules.
style — CSS style, that we want to apply to selected elements.

Příklady

example.com#$#body { background-color: #333!important; }

This rule will apply a style background-color: #333!important; to the body element at example.com and all subdomains.

Výjimky

Just like with element hiding, there is a type of rules that disable the selected CSS style rule for particular domains. Exception rule syntax is almost the same, you just have to change #$# to #@$#.

For example, there is a rule in filter:

#$#.textad { visibility: hidden; }

If you want to disable it for example.com, you can create an exception rule:

example.com#@$#.textad { visibility: hidden; }

We recommend to use this kind of exceptions only if it is not possible to change the CSS rule itself. In other cases it is better to change the original rule, using domain restrictions.

Omezení

Styles that lead to loading any resource are forbidden. Basically, it means that you cannot use any <url> type of value in the style.

Kompatibilita

CSS rules are not supported by AdGuard Content Blocker.

CSS rules may operate differently depending on the platform.

Rozšířené CSS selektory

Omezení
Pseudo-class :has()
Pseudo-class :contains()
Pseudo-třída :matches-css()
Pseudo-class :matches-attr()
Pseudo-class :matches-property()
Pseudo-class :xpath()
Pseudo-class :nth-ancestor()
Pseudo-class :upward()
Pseudo-class :remove() and pseudo-property remove
Pseudo-class :is()
Pseudo-class :not()
Pseudo-class :if-not() (removed)

CSS 3.0 is not always enough to block ads. To solve this problem AdGuard extends CSS capabilities by adding support for the new pseudo-elements. We have developed a separate open-source library for non-standard element selecting and applying CSS styles with extended properties.

The idea of extended capabilities is an opportunity to match DOM elements with selectors based on their own representation (style, text content, etc.) or relations with other elements. There is also an opportunity to apply styles with non-standard CSS properties.

Application area

Extended selectors can be used in any cosmetic rule, whether they are element hiding rules or CSS rules.

Kompatibilita

Rules with extended CSS selectors are not supported by AdGuard Content Blocker.

Syntaxe

Regardless of the CSS pseudo-classes you are using in the rule, you can use special markers to force applying these rules by ExtendedCss. It is recommended to use these markers for all extended CSS cosmetic rules so that it was easier to find them.

The syntax for extended CSS rules:

#?# — for element hiding, #@?# — for exceptions
#$?# — for CSS rules, #@$?# — for exceptions

We strongly recommend using these markers any time when you use an extended CSS selector.

Příklady

example.org#?#div:has(> a[target="_blank"][rel="nofollow"]) — this rule blocks all div elements containing a child node that has a link with the attributes [target="_blank"][rel="nofollow"]. The rule applies only to example.org and its subdomains.
example.com#$?#h3:contains(cookies) { display: none!important; } — this rule sets the style display: none!important to all h3 elements that contain the word cookies. The rule applies only to example.com and all its subdomains.
example.net#?#.banner:matches-css(width: 360px) — this rule blocks all .banner elements with the style property width: 360px. The rule applies only to example.net and its subdomains.
example.net#@?#.banner:matches-css(width: 360px) — this rule will disable the previous rule.

You can apply standard CSS selectors using the ExtendedCss library by using the rule marker #?#, e.g. #?#div.banner.

Learn more about how to debug extended selectors.

poznámka

Some pseudo-classes do not require selector before it. Still adding the universal selector * makes an extended selector easier to read, even though it has no effect on the matching behavior. So selector #block :has(> .inner) works exactly like #block *:has(> .inner), but the second one is more obvious.

Pseudo-class names are case-insensitive, e.g. :HAS() works as :has(). Still the lower-case names are used commonly.

Limitace ExtendedCss

CSS comments and at-rules are not supported.
Specific pseudo-class may have its own limitations: :has(), :xpath(), :nth-ancestor(), :upward(), :is(), :not(), and :remove().

Pseudo-třída `:has()`

Draft CSS 4.0 specification describes the :has() pseudo-class. Unfortunately, it is not yet supported by all popular browsers.

poznámka

Rules with the :has() pseudo-class must use the native implementation of :has() if they use ## marker and if it is possible, i.e. with no other extended selectors inside. To force applying of ExtendedCss rules with :has(), use #?#/#$?# marker explicitly.

Compatibility with other pseudo-classes

Synonyms :-abp-has() is supported by ExtendedCss for better compatibility.

Upozornění na odstranění

:if() is no longer supported as a synonym for :has().

Syntaxe

[target]:has(selector)

target — optional, standard or extended CSS selector, can be skipped for checking any element
selector — required, standard or extended CSS selector

The pseudo-class :has() selects the target elements that fit to the selector. Also the selector can start with a combinator.

A selector list can be set in selector as well. In this case all selectors in the list are being matched for now. In the future it will be fixed for <forgiving-relative-selector-list> as argument.

`:has()` limitations

Usage of the :has() pseudo-class is restricted for some cases (2, 3):

disallow :has() inside the pseudos accepting only compound selectors;
disallow :has() after regular pseudo-elements.

Native :has() pseudo-class does not allow :has(), :is(), :where() inside :has() argument to avoid increasing the :has() invalidation complexity (case 1). But ExtendedCss did not have such limitation earlier and filter lists already contain such rules, so we have not added this limitation to ExtendedCss and allow to use :has() inside :has() as it was possible before. To use it, just force ExtendedCss usage by setting #?#/#$?# rule marker.

Native implementation does not allow any usage of :scope inside the :has() argument ([1], [2]). Still, there are some such rules in filter lists: div:has(:scope a) which we continue to support by simply converting them to div:has(> a), as it used to be done previously.

Příklady

div:has(.banner) selects all div elements which include an element with the banner class:

<!-- HTML code -->
<div>Not selected</div>
<div>Selected
  <span class="banner">inner element</span>
</div>

div:has(> .banner) selects all div elements which include an banner class element as a direct child of div:

<!-- HTML code -->
<div>Not selected</div>
<div>Selected
  <p class="banner">child element</p>
</div>

div:has(+ .banner) selects all div elements preceding banner class element which immediately follows the div and both are children of the same parent:

<!-- HTML code -->
<div>Not selected</div>
<div>Selected</div>
<p class="banner">adjacent sibling</p>
<span>Not selected</span>

div:has(~ .banner) selects all div elements preceding banner class element which follows the div but not necessarily immediately and both are children of the same parent:

<!-- HTML code -->
<div>Not selected</div>
<div>Selected</div>
<span>Not selected</span>
<p class="banner">general sibling</p>

div:has(span, .banner) selects all div elements which include both span element and banner class element:

<!-- HTML code -->
<div>Not selected</div>
<div>Selected
  <span>child span</span>
  <p class="banner">child .banner</p>
</div>

Old syntax

Backward compatible syntax for :has() is supported but not recommended.

Pseudo-class `:contains()`

The :contains() pseudo-class principle is very simple: it allows to select the elements that contain specified text or which content matches a specified regular expression. Regexp flags are supported.

poznámka

The :contains() pseudo-class uses the textContent element property for matching, not the innerHTML.

Compatibility with other pseudo-classes

Synonyms :-abp-contains() and :has-text() are supported for better compatibility.

Syntaxe

[target]:contains(match)

target — optional, standard or extended CSS selector, can be skipped for checking any element
match — required, string or regular expression for matching element textContent. Regular expression flags are supported.

Příklady

For such DOM:

<!-- HTML code -->
<div>Not selected</div>
<div id="match">Selected as IT contains "banner"</div>
<div>Not selected <div class="banner"></div></div>

the element div#match can be selected by any of these extended selectors:

! prostý text
div:contains(banner)

! regular expression
div:contains(/as .*banner/)

! regular expression with flags
div:contains(/it .*banner/gi)

poznámka

Only the div with id=match is selected because the next element does not contain any text, and banner is a part of code, not a text.

Old syntax

Backward compatible syntax for :contains() is supported but not recommended.

Pseudo-třída `:matches-css()`

The :matches-css() pseudo-class allows to match the element by its current style properties. The work of the pseudo-class is based on using the Window.getComputedStyle() method.

Syntaxe

[target]:matches-css([pseudo-element, ] property: pattern)

target — optional, standard or extended CSS selector, can be skipped for checking any element
pseudo-element — optional, valid standard pseudo-element, e.g. before, after, first-line, etc.
property — required, a name of CSS property to check the element for
pattern — required, a value pattern that is using the same simple wildcard matching as in the basic URL filtering rules or a regular expression. For this type of matching, AdGuard always does matching in a case-insensitive manner. In the case of a regular expression, the pattern looks like /regexp/.

Special characters escaping and unescaping

For non-regexp patterns (,),[,] must be unescaped, e.g. :matches-css(background-image:url(data:*)).

For regexp patterns \ should be escaped, e.g. :matches-css(background-image: /^url\\("data:image\\/gif;base64.+/).

Příklady

For such DOM:

<!-- HTML code -->
<style type="text/css">
    #matched::before {
        content: "Block me"
    }
</style>
<div id="matched"></div>
<div id="not-matched"></div>

the div elements with pseudo-element ::before and with specified content property can be selected by any of these extended selectors:

! string pattern
div:matches-css(before, content: block me)

! string pattern with wildcard
div:matches-css(before, content: block*)

! regular expression pattern
div:matches-css(before, content: /block me/)

Omezení

Regexp patterns do not support flags.

Kompatibilita

Obsolete pseudo-classes :matches-css-before() and :matches-css-after() are no longer recommended but still are supported for better compatibility.

Old syntax

Backward compatible syntax for :matches-css() is supported but not recommended.

Pseudo-class `:matches-attr()`

The :matches-attr() pseudo-class allows selecting an element by its attributes, especially if they are randomized.

Syntaxe

[target]:matches-attr("name"[="value"])

target — optional, standard or extended CSS selector, can be skipped for checking any element
name — required, simple string or string with wildcard or regular expression for attribute name matching
value — optional, simple string or string with wildcard or regular expression for attribute value matching

Uvození speciálních znaků

For regexp patterns " and \ should be escaped, e.g. div:matches-attr(class=/[\\w]{5}/).

Příklady

div:matches-attr("ad-link") selects the element div#target1:

<!-- HTML code -->
<div id="target1" ad-link="1random23-banner_240x400"></div>

div:matches-attr("data-*"="adBanner") selects the element div#target2:

<!-- HTML code -->
<div id="target2" data-1random23="adBanner"></div>

div:matches-attr(*unit*=/^click$/) selects the element div#target3:

<!-- HTML code -->
<div id="target3" random123-unit094="click"></div>

*:matches-attr("/.{5,}delay$/"="/^[0-9]*$/") selects the element #target4:

<!-- HTML code -->
<div>
  <inner-random23 id="target4" nt4f5be90delay="1000"></inner-random23>
</div>

Omezení

Regexp patterns do not support flags.

Pseudo-class `:matches-property()`

The :matches-property() pseudo-class allows selecting an element by matching its properties.

Syntaxe

[target]:matches-property("name"[="value"])

target — optional, standard or extended CSS selector, can be skipped for checking any element
name — required, simple string or string with wildcard or regular expression for element property name matching
value — optional, simple string or string with wildcard or regular expression for element property value matching

Uvození speciálních znaků

For regexp patterns " and \ must be escaped, e.g. div:matches-property(prop=/[\\w]{4}/).

poznámka

Regexp patterns are supported in name for any property in chain, e.g. prop./^unit[\\d]{4}$/.type.

Příklady

An element with such properties:

divProperties = {
  id: 1,
  check: {
    track: true,
    unit_2random1: true,
  },
  memoizedProps: {
    key: null,
    tag: 12,
    _owner: {
      effectTag: 1,
      src: 'ad.com',
    },
  },
};

can be selected by any of these extended selectors:

div:matches-property(check.track)

div:matches-property("check./^unit_.{4,8}$/")

div:matches-property("check.unit_*"=true)

div:matches-property(memoizedProps.key="null")

div:matches-property(memoizedProps._owner.src=/ad/)

For filter maintainers

To check properties of a specific element, do the following:

Inspect the page element or select it in Elements tab of browser DevTools
Run console.dir($0) in Console tab

Omezení

Regexp patterns do not support flags.

Pseudo-třída `:xpath()`

The :xpath() pseudo-class allows selecting an element by evaluating an XPath expression.

Syntaxe

[target]:xpath(expression)

target- optional, standard or extended CSS selector
expression — required, valid XPath expression

`:xpath()` limitations

target can be omitted so it is optional. For any other pseudo-class that would mean "apply to all DOM nodes", but in case of :xpath() it just means "apply to the whole document", and such applying slows elements selecting significantly. That's why rules like #?#:xpath(expression) are limited to looking inside the body tag. For example, rule #?#:xpath(//div[@data-st-area=\'Advert\']) is parsed as #?#body:xpath(//div[@data-st-area=\'Advert\']).

Extended selectors with defined target as any selector — *:xpath(expression) — can still be used but it is not recommended, so target should be specified instead.

Works properly only at the end of selector, except for pseudo-class :remove().

Příklady

:xpath(//*[@class="banner"]) selects the element div#target1:

<!-- HTML code -->
<div id="target1" class="banner"></div>

:xpath(//*[@class="inner"]/..) selects the element div#target2:

<!-- HTML code -->
<div id="target2">
  <div class="inner"></div>
</div>

Pseudo-class `:nth-ancestor()`

The :nth-ancestor() pseudo-class allows to lookup the nth ancestor relative to the previously selected element.

subject:nth-ancestor(n)

subjectr — povinný, standardní nebo rozšířený selektor CSS
n — povinné, číslo >= 1 a < 256, vzdálenost k potřebnému předkovi od prvku vybraného pomocí subject

Syntaxe

subject:nth-ancestor(n)

subjectr — povinný, standardní nebo rozšířený selektor CSS
n — povinné, číslo >= 1 a < 256, vzdálenost k potřebnému předkovi od prvku vybraného pomocí subject

`:nth-ancestor()` limitations

The :nth-ancestor() pseudo-class is not supported inside the argument of the :not() pseudo-class.

Příklady

For such DOM:

<!-- HTML code -->
<div id="target1">
  <div class="child"></div>

  <div id="target2">
    <div>
      <div>
        <div class="inner"></div>
      </div>
    </div>
  </div>
</div>

.child:nth-ancestor(1) selects the element div#target1, div[class="inner"]:nth-ancestor(3) selects the element div#target2.

Pseudo-class `:upward()`

The :upward() pseudo-class allows to lookup the ancestor relative to the previously selected element.

Syntaxe

subject:upward(ancestor)

subjectr — povinný, standardní nebo rozšířený selektor CSS
ancestor — required, specification for the ancestor of the element selected by subject, can be set as:
- number >= 1 and < 256 for distance to the needed ancestor, same as :nth-ancestor()
- standard CSS selector for matching closest ancestor

`:upward()` limitations

The :upward() pseudo-class is not supported inside the argument of the :not() pseudo-class.

Příklady

For such DOM:

<!-- HTML code -->
<div id="target1" data="true">
  <div class="child"></div>

  <div id="target2">
    <div>
      <div>
        <div class="inner"></div>
      </div>
    </div>
  </div>
</div>

.inner:upward(div[data]) selects the element div#target1, .inner:upward(div[id]) selects the element div#target2, .child:upward(1) selects the element div#target1, .inner:upward(3) selects the element div#target2.

Pseudo-class `:remove()` and pseudo-property `remove`

Sometimes, it is necessary to remove a matching element instead of hiding it or applying custom styles. In order to do it, you can use the :remove() pseudo-class as well as the remove pseudo-property.

Pseudo-class :remove() can be placed only at the end of a selector.

Syntaxe

! pseudo-class
selector:remove()

! pseudo-property
selector { remove: true; }

selector — required, standard or extended CSS selector

`:remove()` a `remove` limitations

The :remove() pseudo-class is limited to work properly only at the end of selector.

For applying the :remove() pseudo-class to any element, the universal selector * should be used. Otherwise such extended selector may be considered as invalid, e.g. .banner > :remove() is not valid for removing any child element of banner class element, so it should look like .banner > *:remove().

If the :remove() pseudo-class or the remove pseudo-property is used, all style properties are ignored except for the debug pseudo-property.

Příklady

div.banner:remove()
div:has(> div[ad-attr]):remove()

div:contains(advertisement) { remove: true; }
div[class]:has(> a > img) { remove: true; }

poznámka

Rules with the remove pseudo-property must use #$?# marker: $ for CSS-style rule syntax, ? for ExtendedCss syntax.

Pseudo-class `:is()`

The :is() pseudo-class allows to match any element that can be selected by any of selectors passed to it. Invalid selectors are skipped and the pseudo-class deals with valid ones with no error thrown. Our implementation of the native :is() pseudo-class.

Syntaxe

[target]:is(selectors)

target — optional, standard or extended CSS selector, can be skipped for checking any element
selectors — forgiving selector list of standard or extended selectors. For extended selectors, only compound selectors are supported, not complex.

`:is()` limitations

Rules with the :is() pseudo-class must use the native implementation of :is() if rules use ## marker and it is possible, i.e. with no other extended selectors inside. To force applying ExtendedCss rules with :is(), use #?#/#$?# marker explicitly.

If the :is() pseudo-class argument selectors is an extended selector, due to the way how the :is() pseudo-class is implemented in ExtendedCss v2.0, it is impossible to apply it to the top DOM node which is html, i.e. #?#html:is(<extended-selectors>) does not work. So if target is not defined or defined as the universal selector *, the extended pseudo-class applying is limited to html's children, e.g. rules #?#:is(...) and #?#*:is(...) are parsed as #?#html *:is(...). Please note that there is no such limitation for a standard selector argument, i.e. #?#html:is(.locked) works fine.

Complex selectors with extended pseudo-classes are not supported as selectors argument for :is() pseudo-class, only compound ones are allowed. Check examples below for more details.

Příklady

#container *:is(.inner, .footer) selects only the element div#target1:

<!-- HTML code -->
<div id="container">
  <div data="true">
    <div>
      <div id="target1" class="inner"></div>
    </div>
  </div>
</div>

Due to limitations :is(*:not([class]) > .banner)' does not work but :is(*:not([class]):has(> .banner)) can be used instead of it to select the element div#target2:

<!-- HTML code -->
<span class="span">text</span>
<div id="target2">
  <p class="banner">inner paragraph</p>
</div>

Pseudo-class `:not()`

The :not() pseudo-class allows to select elements which are not matched by selectors passed as argument. Invalid argument selectors are not allowed and error is to be thrown. Our implementation of the :not() pseudo-class.

Syntaxe

[target]:not(selectors)

target — optional, standard or extended CSS selector, can be skipped for checking any element
selectors — list of standard or extended selectors

`:not()` limitations

Rules with the :not() pseudo-class must use the native implementation of :not() if rules use ## marker and it is possible, i.e. with no other extended selectors inside. To force applying ExtendedCss rules with :not(), use #?#/#$?# marker explicitly.

If the :not() pseudo-class argument selectors is an extended selector, due to the way how the :not() pseudo-class is implemented in ExtendedCss v2.0, it is impossible to apply it to the top DOM node which is html, i.e. #?#html:not(<extended-selectors>) does not work. So if target is not defined or defined as the universal selector *, the extended pseudo-class applying is limited to html's children, e.g. rules #?#:not(...) and #?#*:not(...) are parsed as #?#html *:not(...). Please note that there is no such limitation for a standard selector argument, i.e. #?#html:not(.locked) works fine.

The :not() is considered as a standard CSS pseudo-class inside the argument of the :upward() pseudo-class because :upward() supports only standard selectors.

"Up-looking" pseudo-classes which are :nth-ancestor() and :upward() are not supported inside selectors argument for :not() pseudo-class.

Příklady

#container > *:not(h2, .text) selects only the element div#target1:

<!-- HTML code -->
<div id="container">
  <h2>Header</h2>
  <div id="target1"></div>
  <span class="text">text</span>
</div>

Pseudo-class `:if-not()` (removed)

Upozornění na odstranění

The :if-not() pseudo-class is removed and is no longer supported. Pravidla s tímto modifikátorem jsou považována za neplatná.

This pseudo-class was basically a shortcut for :not(:has()). It was supported by ExtendedCss for better compatibility with some filters subscriptions.

Přednost kosmetických pravidel

The way element hiding and CSS rules are applied is platform-specific.

In AdGuard for Windows, Mac, and Android, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: element hiding and CSS rules cannot override inline styles. In such cases, it is recommended to use extended selectors or HTML filtering.

In AdGuard Browser Extension, the so called "user stylesheets" are used. They have higher priority than even the inline styles.

Extended CSS selectors use JavaScript to work and basically add an inline style themselves, therefore they can override any style.

HTML pravidla filtrování

In most cases, the basis and cosmetic rules are enough to filter ads. But sometimes it is necessary to change the HTML-code of the page itself before it is loaded. This is when you need filtering rules for HTML content. They allow to indicate the HTML elements to be cut out before the browser loads the page.

Kompatibilita

HTML filtering rules are supported by AdGuard for Windows, AdGuard for Mac, AdGuard for Android, and AdGuard Browser Extension for Firefox. Such rules do not work in extensions for other browsers because they are unable to modify content on network level.

Syntaxe

     selector = [tagName] [attributes] [pseudoClasses]
   combinator = ">"
         rule = [domains] "$$" selector *(combinator selector)
      domains = [domain0, domain1[, ...[, domainN]]]
   attributes = "[" name0 = value0 "]" "[" name1 = value2 "]" ... "[" nameN = valueN "]"
pseudoClasses = pseudoClass *pseudoClass
  pseudoClass = ":" pseudoName [ "(" pseudoArgs ")" ]

tagName — name of the element in lower case, for example, div or script.
domains — domain restriction for the rule. Same principles as in element hiding rule syntax.
attributes — a list of attributes that limit the selection of elements. name — attribute name, value — substring, that is contained in attribute value.
pseudoName — the name of a pseudo-class.
pseudoArgs — the arguments of a function-style pseudo-class.
combinator — an operator that works similarly to the CSS child combinator: that is, the selector on the right of the combinator will only match an element whose direct parent matches the selector on the left of the combinator.

Příklady

HTML code:

<script data-src="/banner.js"></script>

Rule:

example.org$$script[data-src="banner"]

This rule removes all script elements with the attribute data-src containing the substring banner. The rule applies only to example.org and all its subdomains.

Speciální atributy

In addition to usual attributes, which value is every element checked for, there is a set of special attributes that change the way a rule works. Below there is a list of these attributes:

`tag-content`

Deprecation notice

This special attribute may become unsupported in the future. Prefer using the :contains() pseudo-class where it is available.

This is the most frequently used special attribute. It limits selection with those elements whose innerHTML code contains the specified substring.

You must use "" to escape ", for instance: $$script[tag-content="alert(""this is ad"")"]

For example, take a look at this HTML code:

<script type="text/javascript">
    document.write('<div>banner text</div>" />');
</script>

Following rule will delete all script elements with a banner substring in their code:

$$script[tag-content="banner"]

Omezení

The tag-content special attribute must not appear in a selector to the left of a > combinator.

`wildcard`

Deprecation notice

This special attribute may become unsupported in the future. Prefer using the :contains() pseudo-class where it is available.

This special attribute works almost like tag-content and allows you to check the innerHTML code of the document. Rule will check if HTML code of the element fits to the search pattern.

You must use "" to escape ", for instance: $$script[wildcard=""banner""]

For example: $$script[wildcard="*banner*text*"]

It checks if the element code contains the two consecutive substrings banner and text.

Omezení

The wildcard special attribute must not appear in a selector to the left of a > combinator.

`max-length`

Deprecation notice

This special attribute may become unsupported in the future. Prefer using the :contains() pseudo-class with a regular expression where it is available.

Specifies the maximum length for content of HTML element. If this parameter is set and the content length exceeds the value, a rule does not apply to the element.

Default value

If this parameter is not specified, the max-length is considered to be 8192.

Např:

$$div[tag-content="banner"][max-length="400"]

This rule will remove all the div elements, whose code contains the substring banner and the length of which does not exceed 400 characters.

Omezení

The max-length special attribute must not appear in a selector to the left of a > combinator.

`min-length`

Deprecation notice

This special attribute may become unsupported in the future. Prefer using the :contains() pseudo-class with a regular expression where it is available.

Specifies the minimum length for content of HTML element. If this parameter is set and the content length is less than preset value, a rule does not apply to the element.

Např:

$$div[tag-content="banner"][min-length="400"]

This rule will remove all the div elements, whose code contains the substring banner and the length of which exceeds 400 characters.

Omezení

The min-length special attribute must not appear in a selector to the left of a > combinator.

Pseudotřídy

`:contains()`

Syntaxe

:contains(unquoted text)

nebo

:contains(/reg(ular )?ex(pression)?/)

Compatibility

:-abp-contains() and :has-text() are synonyms for :contains().

Kompatibilita

The :contains() pseudo-class is supported by AdGuard for Windows, Mac, and Android with CoreLibs v1.13 or later.

Requires that the inner HTML of the element contains the specified text or matches the specified regular expression.

Omezení

A :contains() pseudo-class must not appear in a selector to the left of a > combinator.

Výjimky

Similar to hiding rules, there is a special type of rules that disable the selected HTML filtering rule for particular domains. The syntax is the same, you just have to change $$ to $@$ .

For example, there is a rule in filter:

$$script[tag-content="banner"]

If you want to disable it for example.com, you can create an exception rule:

example.com$@$script[tag-content="banner"]

Sometimes, it may be necessary to disable all restriction rules. For example, to conduct tests. To do this, use the exclusion rule without specifying a domain.

$@$script[tag-content="banner"]

We recommend to use this kind of exceptions only if it is not possible to change the hiding rule itself. In other cases it is better to change the original rule, using domain restrictions.

Pravidla JavaScript

AdGuard supports a special type of rules that allows you to inject any JavaScript code to websites pages.

We strongly recommend using scriptlets instead of JavaScript rules whenever possible. JS rules are supposed to help with debugging, but as a long-time solution a scriptlet rule should be used.

Syntaxe

rule = [domains] "#%#" script

domains — domain restriction for the rule. Same principles as in element hiding rules.
script — arbitrary JavaScript code in one string.

Příklady

example.org#%#window.__gaq = undefined; executes the code window.__gaq = undefined; on all pages at example.org and all subdomains.

Výjimky

Similar to hiding rules, there is a special type of rules that disable the selected javascript rule for particular domains. The syntax is the same, you just have to change #%# to #@%#.

For example, there is a rule in filter:

#%#window.__gaq = undefined;

If you want to disable it for example.com, you can create an exception rule:

example.com#@%#window.__gaq = undefined;

Sometimes, it may be necessary to disable all restriction rules. For example, to conduct tests. To do this, use the exclusion rule without specifying a domain.

#@%#window.__gaq = undefined;

We recommend to use this kind of exceptions only if it is not possible to change the hiding rule itself. In other cases it is better to change the original rule, using domain restrictions.

Omezení

JavaScript rules can only be used in trusted filters.

Kompatibilita

JavaScript rules are not supported by AdGuard Content Blocker.

Pravidla skriptlet

Scriptlet is a JavaScript function that provides extended capabilities for content blocking. These functions can be used in a declarative manner in AdGuard filtering rules.

poznámka

AdGuard supports a lot of different scriptlets. In order to achieve cross-blocker compatibility, we also support syntax of uBO and ABP.

Blocking rules syntax

[domains]#%#//scriptlet(name[, arguments])

domains — optional, a list of domains where the rule should be applied;
name — required, a name of the scriptlet from AdGuard Scriptlets library;
arguments — optional, a list of string arguments (no other types of arguments are supported).

Příklady

Apply the abort-on-property-read scriptlet on all pages of example.org and its subdomains, and pass it an alert argument:
```
example.org#%#//scriptlet('abort-on-property-read', 'alert')
```
Remove the branding class from all div[class^="inner"] elements on all pages of example.org and its subdomains:
```
example.org#%#//scriptlet('remove-class', 'branding', 'div[class^="inner"]')
```

Exception rules syntax

Exception rules can disable some scriptlets on particular domains. The syntax for exception scriptlet rules is similar to normal scriptlet rules but uses #@%# instead of #%#:

[domains]#@%#//scriptlet([name[, arguments]])

domains — optional, a list of domains where the rule should be applied;
name — optional, a name of the scriptlet to except from the applying; if not set, all scriptlets will not be applied;
arguments — optional, a list of string arguments to match the same blocking rule and disable it.

Příklady

Disable specific scriptlet rule so that only abort-on-property-read is applied only on example.org and its subdomains:

example.org,example.com#%#//scriptlet("abort-on-property-read", "alert")
example.com#@%#//scriptlet("abort-on-property-read", "alert")

Disable all abort-on-property-read scriptlets for example.com and its subdomains:

example.org,example.com#%#//scriptlet("abort-on-property-read", "alert")
example.com#@%#//scriptlet("abort-on-property-read")

Disable all scriptlets for example.com and its subdomains:

example.org,example.com#%#//scriptlet("abort-on-property-read", "alert")
example.com#@%#//scriptlet()

Apply set-constant and set-cookie to any web page, but due to special scriptlet exception rule only the set-constant scriptlet will be applied on example.org and its subdomains:
```
#%#//scriptlet('set-constant', 'adList', 'emptyArr')
#%#//scriptlet('set-cookie', 'accepted', 'true')
example.org#@%#//scriptlet('set-cookie')
```
Apply adjust-setInterval to any web page and set-local-storage-item on example.com and its subdomains, but there are also multiple scriptlet exception rules, so no scriptlet rules will be applied on example.com and its subdomains:
```
#%#//scriptlet('adjust-setInterval', 'count', '*', '0.001')
example.com#%#//scriptlet('set-local-storage-item', 'ALLOW_COOKIES', 'false')
example.com#@%#//scriptlet()
```

Learn more about how to debug scriptlets.

More information about scriptlets can be found on GitHub.

Kompatibilita

Scriptlet rules are not supported by AdGuard Content Blocker.

The full syntax of scriptlet exception rules is supported by AdGuard for Windows, AdGuard for Mac, and AdGuard for Android with CoreLibs v1.16 or later, and AdGuard Browser Extension for Chrome, Firefox, and Edge with TSUrlFilter v3.0 or later. Previous versions only support exception rules that disable specific scriptlets.

Důvěryhodné skriptlety

Trusted scriptlets are scriptlets with extended functionality. It means the same syntax and restrictions. Trusted scriptlet names are prefixed with trusted-, e.g. trusted-set-cookie, to be easily distinguished from common scriptlets.

poznámka

Trusted scriptlets are not compatible with other ad blockers except AdGuard.

Omezení

Trusted scriptlets rules can only be used in trusted filters.

Kompatibilita

Trusted scriptlets rules are not supported by AdGuard Content Blocker.

Learn more about how to debug scriptlets.

More information about trusted scriptlets can be found on GitHub.

Modifikátory pro ostatní typ pravidel

Each rule can be modified using the modifiers described in the following paragraphs.

Syntax {#non-basic-rules-modifiers-syntax}

rule = "[$" modifiers "]" [rule text]
modifiers = modifier0[, modifier1[, ...[, modifierN]]]

modifier — set of the modifiers described below.
rule text — a rule to be modified.

For example, [$domain=example.com,app=test_app]##selector.

In the modifiers values, the following characters must be escaped: [, ], ,, and \ (unless it is used for the escaping). Use \ to escape them. For example, an escaped bracket looks like this: \].

Modifikátor \ Produkty	Aplikace CoreLibs	AdGuard pro Chromium	AdGuard pro Chrome MV3	AdGuard pro Firefox	AdGuard pro iOS	AdGuard pro Safari	Blokátor obsahu AdGuard
$app	✅	❌	❌	❌	❌	❌	❌
$domain	✅	✅	✅ *[1]	✅	✅	✅	❌
$path	✅	✅	❌	✅	✅	✅	❌
$url	✅	✅ *[2]	✅ *[2]	✅ *[2]	❌	❌	❌

poznámka

✅ — plně podporováno
✅ * — podporováno, ale spolehlivost se může lišit nebo se mohou vyskytnout omezení; více informací naleznete v popisu modifikátoru
❌ — nepodporováno

`$app`

$app modifier lets you narrow the rule coverage down to a specific application or a list of applications. The modifier's behavior and syntax perfectly match the corresponding basic rules $app modifier.

Příklady

[$app=org.example.app]example.com##.textad hides a div with the class textad at example.com and all subdomains in requests sent from the org.example.app Android app.
[$app=~org.example.app1|~org.example.app2]example.com##.textad hides a div with the class textad at example.com and all subdomains in requests sent from any app except org.example.app1 and org.example.app2.
[$app=com.apple.Safari]example.org#%#//scriptlet('prevent-setInterval', 'check', '!300') applies scriptlet prevent-setInterval only in Safari browser on Mac.
[$app=org.example.app]#@#.textad disables all ##.textad rules for all domains while using org.example.app.

Kompatibilita

Such rules with $app modifier are supported by AdGuard for Windows, AdGuard for Mac, and AdGuard for Android.

`$domain`

$domain modifier limits the rule application area to a list of domains and their subdomains. The modifier's behavior and syntax perfectly match the corresponding basic rules $domain modifier.

Příklady

[$domain=example.com]##.textad — hides a div with the class textad at example.com and all subdomains.
[$domain=example.com|example.org]###adblock — hides an element with attribute id equals adblock at example.com, example.org and all subdomains.
[$domain=~example.com]##.textad — this rule hides div elements of the class textad for all domains, except example.com and its subdomains.

There are 2 ways to specify domain restrictions for non-basic rules:

the "classic" way is to specify domains before rule mask and attributes: example.com##.textad;
the modifier approach is to specify domains via $domain modifier: [$domain=example.com]##.textad.

But rules with mixed style domains restriction are considered invalid. So, for example, the rule [$domain=example.org]example.com##.textad will be ignored.

Nezákladní omezení modifikátoru `$domain`

Omezení

Vzhledem k tomu, že nezákladní modifikátor $domain funguje stejně jako základní, má stejná omezení.

Kompatibilita

Such rules with $domain modifier are supported by AdGuard for Windows, AdGuard for Mac, AdGuard for Android, AdGuard Browser Extension for Chrome, for Chrome MV3, Firefox, and Edge.

`$path`

$path modifier limits the rule application area to specific locations or pages on websites.

Syntaxe

$path ["=" pattern]

pattern — optional, a path mask to which the rule is restricted. Its syntax and behavior are pretty much the same as with the pattern for basic rules. You can also use special characters, except for ||, which does not make any sense in this case (see examples below).

If pattern is not set for $path, rule will apply only on the main page of website.

$path modifier matches the query string as well.

$path modifier supports regular expressions in the same way basic rules do.

Příklady

[$path=page.html]##.textad hides a div with the class textad at /page.html or /page.html?<query> or /sub/page.html or /another_page.html
[$path=/page.html]##.textad hides a div with the class textad at /page.html or /page.html?<query> or /sub/page.html of any domain but not at /another_page.html
[$path=|/page.html]##.textad hides a div with the class textad at /page.html or /page.html?<query> of any domain but not at /sub/page.html
[$path=/page.html|]##.textad hides a div with the class textad at /page.html or /sub/page.html of any domain but not at /page.html?<query>
[$path=/page*.html]example.com##.textad hides a div with the class textad at /page1.html or /page2.html or any other path matching /page<...>.html of example.com
[$path]example.com##.textad hides a div with the class textad at the main page of example.com
[$domain=example.com,path=/page.html]##.textad hides a div with the class textad at page.html of example.com and all subdomains but not at another_page.html
[$path=/\\/(sub1|sub2)\\/page\\.html/]##.textad hides a div with the class textad at both /sub1/page.html and /sub2/page.html of any domain (please note the escaped special characters)

Kompatibilita

Rules with $path modifier are not supported by AdGuard Content Blocker.

`$url`

$url modifier limits the rule application area to URLs matching the specified mask.

Syntaxe

url = pattern

where pattern is pretty much the same as pattern of the basic rules assuming that some characters must be escaped. The special characters and regular expressions are supported as well.

Příklady

[$url=||example.com/content/*]##div.textad hides a div with the class textad at addresses like https://example.com/content/article.html and even https://subdomain.example.com/content/article.html.
[$url=||example.org^]###adblock hides an element with attribute id equal to adblock at example.org and its subdomains.
[$url=/\[a-z\]+\\.example\\.com^/]##.textad hides div elements of the class textad for all domains matching the regular expression [a-z]+\.example\.com^.

omezení modifikátoru `$url`

Omezení

In AdGuard Browser Extension, non-basic $url modifier is not compatible with domain-specific rules and other non-basic modifiers — $domain and $path. For example, the rule [$url=/category/*]example.com###textad will not be applied.

Kompatibilita

Rules with the $url modifier are supported by AdGuard for Windows, AdGuard for Mac, and AdGuard for Android with CoreLibs v1.11 or later, and AdGuard Browser Extension with TSUrlFilter v3.0.0 or later.

Information for filter maintainers

If you maintain a third-party filter that is known to AdGuard, you might be interested in the information presented in this section. Please note that hints will be applied to registered filters only. The filter is considered to be registered and known by AdGuard, if it is present in the known filters index. If you want your filter to be registered, please file an issue to AdguardFilters repo.

Direktivy preprocesoru

We provide preprocessor directives that can be used by filter maintainers to improve compatibility with different ad blockers and provide:

including a file
applying rules conditionally by ad blocker type
content blocker specifying for rules applying in Safari

poznámka

Any mistake in a preprocessor directive will lead to AdGuard failing the filter update in the same way as if the filter URL was unavailable.

Preprocessor directives can be used in the user rules or in the custom filters.

Zahrnutý soubor

The !#include directive allows to include contents of a specified file into the filter. It supports only files from the same origin to make sure that the filter maintainer is in control of the specified file. The included file can also contain pre-directives (even other !#include directives). Ad blockers should consider the case of recursive !#include and implement a protection mechanism.

Syntaxe

!#include file_path

where file_path is a same origin absolute or relative file path to be included.

The files must originate from the same domain, but may be located in a different folder.

If included file is not found or unavailable, the whole filter update should fail.

Same-origin limitation should be disabled for local custom filters.

Příklady

URL filtru: https://example.org/path/filter.txt

! Valid (same origin):
!#include https://example.org/path/includedfile.txt
!
! Valid (relative path):
!#include /includedfile.txt
!#include ../path2/includedfile.txt
!
! Invalid (another origin):
!#include https://domain.com/path/includedfile.txt

Podmínky

Správci filtrů mohou pomocí podmínek zadávat různá pravidla v závislosti na typu blokátoru reklam. Podmíněná direktiva začínající direktivou !#if musí být explicitně ukončena direktivou !#endif. Podmínky podporují všechny základní logické operátory.

Existují dva možné scénáře:

Pokud blokátor reklamy narazí na direktivu !#if a ne !#else, zkompiluje kód mezi direktivami !#if a !#endif pouze v případě, že je zadaná podmínka pravdivá.
Pokud existuje direktiva !#else, bude zkompilován kód mezi !#if a !#else, pokud je podmínka pravdivá; v opačném případě bude zkompilován kód mezi !#else a !#endif.

poznámka

Na mezerách záleží. !#if je platná direktiva, zatímco !# if není.

Syntaxe

!#if (conditions)
rules_list
!#endif

nebo

!#if (conditions)
true_conditions_rules_list
!#else
false_conditions_rules_list
!#endif

kde:

!#if (conditions) — začátek bloku při splnění podmínek
conditions — stejně jako v některých populárních programovacích jazycích jsou podmínky preprocesoru založeny na konstantách deklarovaných blokátory reklamy. Autoři blokátorů reklam si sami určují, jaké konstanty přesně deklarují. Přípustné hodnoty:
- adguard vždy deklarováno; ukazuje správcům, že se jedná o jeden z produktů AdGuard; mělo by to stačit v 95 % případů
- konstanty specifické pro daný produkt pro případy, kdy potřebujete, aby pravidlo fungovalo (nebo nefungovalo — pak je třeba před konstantou použít !) pouze v konkrétním produktu:
  - adguard_app_windows — AdGuard pro Windows
  - adguard_app_mac — AdGuard pro Mac
  - adguard_app_android — AdGuard pro Android
  - adguard_app_ios — AdGuard pro iOS
  - adguard_ext_safari — AdGuard pro Safari
  - adguard_ext_chromium — Rozšíření prohlížeče AdGuard pro Chrome (a prohlížeče založené na chromium, např. nový Microsoft Edge.)
  - adguard_ext_chromium_mv3 — AdGuard pro Chrome MV3
  - adguard_ext_firefox — Rozšíření prohlížeče AdGuard pro Firefox
  - adguard_ext_edge — Rozšíření prohlížeče AdGuard pro starší Edge
  - adguard_ext_opera — Rozšíření prohlížeče AdGuard pro Operu
  - adguard_ext_android_cb — Blokátor obsahu AdGuard pro mobilní prohlížeče Samsung a Yandex
  - ext_ublock — speciální případ; ten je deklarován, když je verze filtru uBlock kompilována pomocí FiltersRegistry
  - cap_html_filtering — produkty, které podporují pravidla filtrování HTML: AdGuard pro Windows, AdGuard pro macOS a AdGuard pro Android
!#else — začátek blokování při nesplnění podmínek
rules_list, true_conditions_rules_list, false_conditions_rules_list — seznamy pravidel
!#endif — konec blokování

Příklady

! for all AdGuard products except AdGuard for Safari
!#if (adguard && !adguard_ext_safari)
||example.org^$third-party
domain.com##div.ad
!#endif

! directives even can be combined
!#if (adguard_app_android)
!#include /androidspecific.txt
!#endif

!#if (adguard && !adguard_ext_safari)
! pro všechny produkty AdGuardu kromě AdGuardu pro Safari
||example.org^$third-party
domain.com##div.ad
!#else
! pouze pro AdGuard pro Safari
||subdomena.example.org^$third-party
!#endif

Kompatibilita

Direktivu !#else podporuje FiltersDownloader v1.1.20 nebo novější.

Je již podporována pro seznamy filtrů sestavené pomocí FiltersRegistry, ale stále nemusí být podporována produkty AdGuardu při přidání seznamu filtrů s !#else jako vlastních. Následující produkty ji budou podporovat ve zmíněných nebo novějších verzích:

AdGuard pro Windows, macOS a Android s CoreLibs v1.13;
Rozšíření prohlížeče AdGuard v4.2.208;
AdGuard v1.11.16 pro Safari.

Afinita Safari

Limit Safari pro každý blokátor obsahu je 150000 aktivních pravidel. V aplikacích AdGuard pro Safari a AdGuard pro iOS jsme však pravidla rozdělili do 6 blokátorů obsahu, čímž jsme zvýšili limit pravidel na 900000.

Zde je složení jednotlivých blokátorů obsahu:

AdGuard General — Blokování reklam, jazykově specifické filtry
AdGuard Privacy — Soukromí
AdGuard Social — Sociální widgety, obtěžování
AdGuard Security — Zabezpečení
AdGuard Other — Jiné
AdGuard Custom — Vlastní

Uživatelská pravidla a Seznam povolených jsou přidány do každého blokátoru obsahu.

pozor

Hlavní nevýhodou používání více blokátorů obsahu je, že pravidla různých blokátorů se uplatňují nezávisle. Na pravidla blokování to nemá vliv, ale pro pravidla odblokování mohou způsobit problémy. Pokud je pravidlo blokování v jednom blokátoru obsahu a výjimka v jiném, výjimka nebude fungovat. Správci filtrů používají !#safari_cb_affinity k definování afinity blokátorů obsahu Safari pro pravidla uvnitř blokování direktiv.

Syntaxe

!#safari_cb_affinity(content_blockers)
rules_list
!#safari_cb_affinity

kde:

!#safari_cb_affinity(content_blockers) — počátek blokování
content_blockers — seznam blokátorů obsahu oddělený čárkami. Přípustné hodnoty:
- general — blokátor obsahu AdGuard General
- privacy — blokátor obsahu AdGuard Privacy
- social — blokátor obsahu AdGuard Social
- security — blokátor obsahu AdGuard Security
- other — blokátor obsahu AdGuard Other
- custom — blokátor obsahu AdGuard Custom
- all — speciální klíčové slovo, které znamená, že pravidla musí být zahrnuta do všech blokátorů obsahu
rules_list — seznam pravidel
!#safari_cb_affinity — konec blokování

Příklady

! to unhide specific element which is hidden by AdGuard Base filter:
!#safari_cb_affinity(general)
example.org#@#.adBanner
!#safari_cb_affinity

! to allowlist basic rule from AdGuard Tracking Protection filter:
!#safari_cb_affinity(privacy)
@@||example.org^
!#safari_cb_affinity

Nápovědy

"Nápověda" je speciální komentář, instrukce pro kompilátor filtrů používaný na straně serveru (viz FiltersRegistry).

Syntaxe

!+ HINT_NAME1(PARAMS) HINT_NAME2(PARAMS)

Lze použít více nápověd.

Nápověda `NOT_OPTIMIZED`

Pro každý filtr sestavuje AdGuard dvě verze: plnou a optimalizovanou. Optimalizovaná verze je mnohem jednodušší a neobsahuje pravidla, která se nepoužívají vůbec nebo jen zřídka.

Frekvence používání pravidel vychází ze shromážděných statistik pravidel filtrování. Optimalizace filtrů je však založena na více než na tom — některé filtry mají specifickou konfiguraci. Takto to vypadá pro Základní filtr:

"filter": AdGuard Base filter,
"percent": 30,
"minPercent": 20,
"maxPercent": 40,
"strict": true

kde:

filter — identifikátor filtru
percent — očekávané procento optimalizace ~= (počet pravidel v optimalizovaném filtru) / (počet pravidel v původním filtru) * 100
minPercent — dolní mez hodnoty percent
maxPercent — horní mez hodnoty percent value
strict — pokud je percent < minPercent NEBO percent > maxPercent a je zapnutý přísný režim, pak by kompilace filtru měla selhat, jinak je nutné použít původní pravidla

Jinými slovy, percent je "úroveň komprese". Například pro Základní filtr je nastavena na 40 %. To znamená, že optimalizační algoritmus by měl odstranit 60 % pravidel.

Nakonec zde jsou dvě verze základního filtru pro Rozšíření prohlížeče AdGuard:

úplná: https://filters.adtidy.org/extension/chromium/filters/2.txt
optimalizovaná: https://filters.adtidy.org/extension/chromium/filters/2_optimized.txt

Pokud chcete přidat pravidlo, které by nemělo být při optimalizaci odstraněno, použijte nápovědu NOT_OPTIMIZED:

!+ NOT_OPTIMIZED
||example.org^

Toto pravidlo nebude optimalizováno pouze pro AdGuard pro Android:

!+ NOT_OPTIMIZED PLATFORM(android)
||example.org^

Nápověda `PLATFORM` a `NOT_PLATFORM`

Slouží k zadání platforem pro použití pravidel. Seznam existujících platforem a odkazy např. na Základní filtr:

windows — AdGuard pro Windows — https://filters.adtidy.org/windows/filters/2.txt
mac — AdGuard pro Mac — https://filters.adtidy.org/mac_v2/filters/2.txt
android — AdGuard pro Android — https://filters.adtidy.org/android/filters/2.txt
ios — AdGuard pro iOS — https://filters.adtidy.org/ios/filters/2.txt
ext_chromium — Rozšíření prohlížeče AdGuard pro Chrome — https://filters.adtidy.org/extension/chromium/filters/2.txt
ext_chromium_mv3 — Rozšíření prohlížeče AdGuard pro Chrome MV3 — https://filters.adtidy.org/extension/chromium-mv3/filters/2.txt
ext_ff — Rozšíření prohlížeče AdGuard pro Firefox — https://filters.adtidy.org/extension/firefox/filters/2.txt
ext_edge — Rozšíření prohlížeče AdGuard pro Edge — https://filters.adtidy.org/extension/edge/filters/2.txt
ext_opera — Rozšíření prohlížeče AdGuard pro Operu — https://filters.adtidy.org/extension/opera/filters/2.txt
ext_safari — AdGuard pro Safari — https://filters.adtidy.org/extension/safari/filters/2.txt
ext_android_cb — Blokátor obsahu AdGuard — https://filters.adtidy.org/extension/android-content-blocker/filters/2.txt
ext_ublock — uBlock Origin — https://filters.adtidy.org/extension/ublock/filters/2.txt

Příklady

Toto pravidlo bude dostupné pouze v AdGuardu pro Windows, Mac a Android:

!+ PLATFORM(windows,mac,android)
||example.org^

S výjimkou AdGuardu pro Safari, Blokátoru obsahu AdGuard a AdGuardu pro iOS je toto pravidlo k dispozici na všech platformách:

!+ NOT_PLATFORM(ext_safari, ext_android_cb, ios)
||example.org^

Jak ladit pravidla filtrování

Jednoduchá pravidla filtrování je možné vytvořit "v hlavě", ale pro cokoli alespoň trochu složitějšího budete potřebovat další nástroje pro jejich ladění a iteraci. Existují nástroje, které vám s tím pomohou. V prohlížeči Chrome a jeho analogiích v ostatních prohlížečích můžete použít nástroj DevTools, ale většina produktů AdGuardu nabízí ještě jeden — Záznam filtrování.

Záznam filtrování

Záznam filtrování je pokročilý nástroj, který bude užitečný především pro vývojáře filtrů. Obsahuje seznam všech webových požadavků, které procházejí skrze AdGuard, poskytuje vyčerpávající informace o každém z nich, nabízí několik možností třídění a další užitečné funkce.

V závislosti na tom, který AdGuard produkt používáte, se protokol filtrování může nacházet na různých místech.

V AdGuardu pro Windows jej najdete na kartě Blokátor reklam nebo prostřednictvím nabídky na hlavním panelu
V AdGuardu pro Mac je pod Nastavení → Pokročilé → Záznam filtrování
V AdGuardu pro Android je pod Statistiky → Nedávná aktivita. Nedávná aktivita je také přístupná z Asistenta
V Rozšíření prohlížeče AdGuard je přístupný z karty Různé nebo kliknutím pravým tlačítkem myši na ikonu rozšíření. Pouze prohlížeče založené na platformě Chromium a Firefox zobrazují použití pravidel skrývání prvků (včetně CSS, ExtCSS) a pravidel JS a skripletů v jejich záznamech filtrování

poznámka

V AdGuardu pro iOS a AdGuardu pro Safari Záznam filtrování neexistuje kvůli způsobu, jakým jsou v Safari implementovány blokátory obsahu. AdGuard tyto webové požadavky nevidí, a proto je nemůže zobrazit.

Režim ladění selektorů

Někdy můžete potřebovat zkontrolovat výkonnost daného selektoru nebo souboru stylů. Abyste to mohli provést bez přímé interakce s JavaScript, můžete použít speciální vlastnost stylu debug. Když ExtendedCss splňuje tuto vlastnost, povolí režim ladění buď pro jeden selektor, nebo pro všechny selektory v závislosti na hodnotě debug.

Otevřete konzolu prohlížeče na webové stránce a zobrazte statistiky časování pro selektor(y), které zde byly použity. Režim ladění zobrazí následující statistiky jako objekt, kde každý z laděných selektorů je klíč a hodnota je objekt s těmito vlastnostmi:

Vždy vytištěno:

selectorParsed — text parsovaného selektoru se může lišit od vstupního textu
timings — seznam uzlů DOM odpovídajících selektoru
- appliesCount — celkový počet použití selektoru na stránce
- appliesTimings — doba, po kterou byl selektor na stránce použit, pro každý případ, kdy byl použit (v milisekundách)
- meanTiming — průměrná doba, po kterou byl selektor na stránce použit
- standardDeviation — standardní odchylka
- timingsSum — celkový čas potřebný k použití selektoru na stránce ve všech instancích

Vytištěno pouze pro odstranění pseudonymů:

removed — příznak signalizující, zda byly prvky odstraněny

Vytištěno, pokud prvky nejsou odstraněny:

matchedElements — seznam uzlů DOM odpovídajících selektoru
styleApplied — parsovaná deklarace stylu pravidla související se selektorem

Příklady

Ladění jednoho selektoru:

Pokud je hodnota vlastnosti debug true, zobrazí se v konzole prohlížeče pouze informace o tomto selektoru.

#$?#.banner { display: none; debug: true; }

Povolení globálního ladění:

Pokud je hodnota vlastnosti debug global, konzola zobrazí informace o všech rozšířených selektorech CSS, které mají na aktuální stránce shodu pro všechna pravidla z libovolného povoleného filtru.

#$?#.banner { display: none; debug: global; }

Testování rozšířených selektorů bez AdGuardu

ExtendedCss lze spustit na libovolné stránce bez použití AdGuard produktu. Za tímto účelem byste měli zkopírovat a spustit následující kód v konzoli prohlížeče:

!function(e,t,d){C=e.createElement(t),C.src=d,C.onload=function(){alert("ExtendedCss loaded successfully")},s=e.getElementsByTagName(t)[0],s?s.parentNode.insertBefore(C,s):(h=e.getElementsByTagName("head")[0],h.appendChild(C))}(document,"script","https://AdguardTeam.github.io/ExtendedCss/extended-css.min.js");

Případně nainstalujte uživatelský skript ExtendedCssDebugger.

Nyní můžete použít ExtendedCss z globálního rozsahu a spustit jeho metodu query() jako Document.querySelectorAll().

Příklady

const selector = 'div.block:has=(.header:matches-css(after, content: Ads))';

// array of HTMLElements matched the `selector` is to be returned
ExtendedCss.query(selector);

Ladění skriptletů

Pokud používáte Rozšíření prohlížeče AdGuard a chcete vyladit pravidlo skriptlet nebo důvěryhodný skriptlet, můžete získat další informace otevřením protokolu filtrování. V takovém případě se skriptlety přepnou do režimu ladění a v konzoli prohlížeče se zobrazí více informací.

Následující skriptlety jsou speciálně vyvinuty zejména pro účely ladění:

Následující skriptlety lze také použít pro účely ladění:

json-prune
prevent-fetch
prevent-requestAnimationFrame
prevent-setInterval
prevent-setTimeout
prevent-window-open se specifickým parametrem replacement
prevent-xhr
trusted-replace-fetch-response
trusted-replace-xhr-response

Legenda tabulek kompatibility

Zkratky produktů

aplikací CoreLibs — AdGuard pro Windows, AdGuard pro Mac a AdGuard pro Android
AdGuard pro Chromium — Rozšíření prohlížeče AdGuard pro Chrome a další prohlížeče založené na Chromium, např. nový Microsoft Edge, Opera
Adguard pro Chrome MV3 — Rozšíření prohlížeče AdGuard pro Chrome MV3
Adguard pro Firefox — Rozšíření prohlížeče AdGuard pro Firefox
AdGuard pro iOS — AdGuard pro iOS a AdGuard pro iOS Pro (pro mobilní prohlížeč Safari)
AdGuard pro Safari — AdGuard pro desktopový prohlížeč Safari
Blokátor obsahu AdGuard — blokátor obsahu pro mobilní prohlížeče Android: Samsung Internet a Yandex Browser

Zkratky kompatibility

poznámka

✅ — plně podporováno
✅ * — podporováno, ale spolehlivost se může lišit nebo se mohou vyskytnout omezení; více informací naleznete v popisu modifikátoru
🧩 — může být již implementováno ve verzích nightly nebo beta, ale není ještě podporováno ve verzích pro vydání
⏳ - funkce, jejíž implementace se plánuje, ale zatím není k dispozici v žádném produktu
❌ — nepodporováno
👎 — zastaralé; stále podporovano, ale v budoucnu bude odstraněno
🚫 — odstraněno a již nepodporováno

Komentáře
Příklady
Omezení a restrikce
- Důvěryhodné filtry
- Blokátor obsahu AdGuard
Základní pravidla
Ostatní pravidla
Kosmetická pravidla
HTML pravidla filtrování
Pravidla JavaScript
Pravidla skriptlet
- Důvěryhodné skriptlety
Modifikátory pro ostatní typ pravidel
Information for filter maintainers
- Direktivy preprocesoru
- Nápovědy
  - Nápověda NOT_OPTIMIZED
  - Nápověda PLATFORM a NOT_PLATFORM
Jak ladit pravidla filtrování
Legenda tabulek kompatibility
- Zkratky produktů
- Zkratky kompatibility

Komentáře​

Příklady​

Blokování podle názvu domény​

Blokování přesné adresy​

Modifikátory základních pravidel​

Odblokování adresy​

Odblokování celé webové stránky​

Kosmetické pravidlo​

Omezení a restrikce​

Důvěryhodné filtry​

Blokátor obsahu AdGuard​

Základní pravidla​

Syntaxe základních pravidel​

Speciální znaky​

Podpora regulárních výrazů​

Podpora zástupných znaků pro TLD (domény nejvyšší úrovně)​

Příklady základních pravidel​

Modifikátory základních pravidel​

Základní modifikátory​

$app​

$denyallow​

$domain​

omezení modifikátoru $domain​

$header​

omezení modifikátoru $header​

$important​

$match-case​

$method​

$popup​

omezení modifikátoru $popup​

$strict-first-party​

$strict-third-party​

$third-party​

$to​

Modifikátory typu obsahu​

$document​

$font​

$image​

$media​

$object​

$other​

$ping​

omezení modifikátoru $ping​

$script​

$stylesheet​

$subdocument​

omezení modifikátoru $subdocument​

$websocket​

omezení modifikátoru $websocket​

$xmlhttprequest​

$object-subrequest (odstraněno)​

$webrtc (odstraněno)​

Modifikátory pravidel pro výjimky​

$content​

$elemhide​

$extension​

$jsinject​

omezení modifikátoru $jsinject​

$stealth​

$urlblock​

omezení modifikátoru $urlblock​

Generická pravidla​

$genericblock​

omezení modifikátoru $genericblock​

$generichide​

specifichide​

Pokročilé schopnosti​

$all​

omezení modifikátoru $all​

$badfilter​

omezení modifikátoru $badfilter​

$cookie​

omezení modifikátoru $cookie​

$csp​

$hls​

$inline-script​

$inline-font​

$jsonprune​

$xmlprune​

$network​

Komentáře

Příklady

Blokování podle názvu domény

Blokování přesné adresy

Modifikátory základních pravidel

Odblokování adresy

Odblokování celé webové stránky

Kosmetické pravidlo

Omezení a restrikce

Důvěryhodné filtry

Blokátor obsahu AdGuard

Základní pravidla

Syntaxe základních pravidel

Speciální znaky

Podpora regulárních výrazů

Podpora zástupných znaků pro TLD (domény nejvyšší úrovně)

Příklady základních pravidel

Modifikátory základních pravidel

Základní modifikátory

`$app`

`$denyallow`

`$domain`

omezení modifikátoru `$domain`

`$header`

omezení modifikátoru `$header`

`$important`

`$match-case`

`$method`

`$popup`

omezení modifikátoru `$popup`

`$strict-first-party`

`$strict-third-party`

`$third-party`

`$to`

Modifikátory typu obsahu

`$document`

`$font`

`$image`

`$media`

`$object`

`$other`

`$ping`

omezení modifikátoru `$ping`

`$script`

`$stylesheet`

`$subdocument`

omezení modifikátoru `$subdocument`

`$websocket`

omezení modifikátoru `$websocket`

`$xmlhttprequest`

`$object-subrequest` (odstraněno)

`$webrtc` (odstraněno)

Modifikátory pravidel pro výjimky

`$content`

`$elemhide`

`$extension`

`$jsinject`

omezení modifikátoru `$jsinject`

`$stealth`

`$urlblock`

omezení modifikátoru `$urlblock`

Generická pravidla

`$genericblock`

omezení modifikátoru `$genericblock`

`$generichide`

`specifichide`

Pokročilé schopnosti

`$all`

omezení modifikátoru `$all`

`$badfilter`

omezení modifikátoru `$badfilter`

`$cookie`

omezení modifikátoru `$cookie`

`$csp`

`$hls`

`$inline-script`

`$inline-font`

`$jsonprune`

`$xmlprune`

`$network`