Přejít k hlavnímu obsahu

AdGuard Browser Extension MV3

Chrome has removed all remaining Manifest V2 (MV2) extensions from the Chrome Web Store, and other Chromium-based browsers, Opera and Microsoft Edge among them, are moving to MV3 as well. Users of these browsers need an MV3 extension, compatible with the new API Manifest V3. Our thoughts on this topic are extensively discussed on our blog.

Naše rozšíření MV3 účinně blokuje reklamy a slídiče a zároveň bezproblémově spravuje sociální widgety, bannery a videoreklamy. Většina uživatelů nezaznamená žádné provozní rozdíly, ale je třeba si uvědomit některá omezení a změny.

Kde najdete naše rozšíření​

The MV3 version is our primary Chrome extension and is available in the Chrome Web Store. MV3 builds are also published on GitHub Releases as chrome-mv3.zip for Chrome and opera-mv3.zip for Opera.

The MV3 beta is available in the Chrome Web Store.

AdGuard Ad Blocker MV2 was removed from the Chrome Web Store together with all other MV2 extensions. MV2 keeps working in Firefox and in Chromium-based browsers that retained support for it — see How to keep using AdGuard after Chrome removed MV2.

Hlavní změny funkcí a nastavení​

  • Filter updates. The options Auto-update filters and Check filters update are not available in the Filters tab: rules that ship as part of the extension can be updated only together with a new extension version, after store review. Keep automatic extension updates enabled in your browser.

    Custom filters you add by URL update on their own, independently of extension updates.

  • AdGuard Quick Fixes filter. Because built-in rules can’t be updated on request, the extension ships the AdGuard Quick Fixes filter. It uses dynamic rules to react to newly introduced ads and broken websites between releases, so keep it enabled.

  • Filtering log

    Filtering log *border

    Due to DNR restrictions, we can’t show exactly which rule worked, but we will provide an “assumed rule that was triggered” based on our engine. For precise information, you’ll need to install the “unpacked” form of the extension in your browser yourself. You’ll find detailed instructions on how to do this in a separate article.

  • Tracking protection (formerly known as Stealth mode)

    Tracking protection *border

    There are no Cookies section, along with Self-destruction of first-party cookies and Self-destruction of third-party cookies since we cannot set the TTL of cookies using declarative rules.

  • Phishing & malware protection is no longer available in the general settings. To protect yourself from malicious websites and scams, enable the appropriate Security filters in the Filters tab.

    Security *border

Omezení​

Maximální počet pravidel a filtrů​

Manifest V3 zavádí omezení statických a regexových pravidel na jedno rozšíření. Uživatelé mohou dostávat oznámení o překročení těchto limitů.

Rule limits *border

Too many extensions *border

Manifest V3 v zásadě dělí pravidla na statická (vestavěná) a dynamická s přísnými omezeními.

Statická pravidla: minimálně 30000 pravidel na jedno rozšíření s kumulativním limitem 330000 pro všechna rozšíření nainstalovaná jedním uživatelem.

Pro regexová pravidla je nastaven limit 1000 na jedno rozšíření.

Maximální počet současně aktivovaných filtrů je 50.

Dynamická pravidla: je stanoven přísný limit 5000 pravidel, který zahrnuje maximálně 1000 regexových pravidel.

Pokud je tento limit překročen, bude použito pouze 5000 převedených pravidel v následujícím pořadí: nejprve seznam povolených, poté uživatelská pravidla, vlastní filtry a nakonec — filtr rychlých oprav.

Převedená pravidla jsou pravidla, která byla převedena do formátu [DNR] pomocí deklarativního převodníku. Během tohoto převodu mohou některá pravidla přepsat jiná ($badfilter), některá mohou být sloučena ($removeparam), takže vznikne seznam pravidel s mírně odlišným pořadím.

Z tohoto seznamu převedených pravidel použijeme pouze 5000 pravidel. Ostatní se v editoru zobrazí, ale nepoužijí se.

Here’s how a rule with a basic modifier is converted to a declarative rule:

||example.org^$script,third-party,domain=example.com

je převedeno na

[
    {
        "id": 1,
        "action": {
            "type": "block"
        },
        "condition": {
            "urlFilter": "||example.org^",
            "domainType": "thirdParty",
            "initiatorDomains": [
                "example.com"
            ],
            "resourceTypes": [
                "script"
            ]
        },
        "priority": 302
    }
]

Další příklady najdete na GitHubu.

Modifikátory síťových pravidel​

Modifikátory síťových pravidel mají svá omezení: některé z nich nelze v MV3 implementovat nebo je lze implementovat pouze s omezeními.

Další podrobnosti o omezeních najdete na GitHubu. Další informace o modifikátorech naleznete v naší Databázi znalostí.