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.

Unsere MV3-Erweiterung sperrt effektiv Werbung und Tracker und verwaltet gleichzeitig nahtlos soziale Widgets, Banner und Videoanzeigen. Die meisten Benutzer:innen werden keine Unterschiede bei der Bedienung feststellen, aber es gibt einige Einschränkungen und Änderungen, die zu beachten sind.

Wo Sie unsere Erweiterungen finden

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.

Wichtigste Änderungen bei Funktionen und Einstellungen

• 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

  

  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)

  

  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.

  

Beschränkungen

Maximale Anzahl von Regeln und Filtern

Manifest V3 legt Grenzen für statische und Regex-Regeln pro Erweiterung fest. Die Nutzer:innen können Benachrichtigungen erhalten, wenn diese Grenzen überschritten werden.

Grundsätzlich unterteilt Manifest V3 die Regeln in statische (integrierte) und dynamische Regeln, wobei strenge Grenzen gelten.

Statische Regeln: mindestens 30.000 Regeln pro Erweiterung, mit einem kumulativen Limit von 330.000 für alle von einem einzelnen Benutzer installierten Erweiterungen.

Für Regex-Regeln ist die Grenze auf 1.000 pro Erweiterung festgelegt.

Die maximale Anzahl der gleichzeitig aktivierten Filter beträgt 50.

Dynamische Regeln: Es gilt eine strikte Obergrenze von 5.000 Regeln, darunter maximal 1.000 Regex-Regeln.

Wenn diese Grenze überschritten wird, werden nur 5.000 umgewandelte Regeln in der folgenden Reihenfolge angewendet: zuerst Freigabeliste, dann Benutzerregeln und schließlich benutzerdefinierte Filter.

Konvertierte Regeln sind Regeln, die mit dem deklarativen Konverter in das [DNR-Format] umgewandelt wurden. Während dieses Umwandlungsprozesses können einige Regeln andere überschreiben ($badfilter), einige können kombiniert werden ($removeparam), was zu einer Liste von Regeln mit einer etwas anderen Reihenfolge führt.

Von dieser Liste der konvertierter Regeln werden nur 5.000 Regeln verwendet. Die übrigen werden zwar im Editor angezeigt, aber nicht angewendet.

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

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

wird umgewandelt in

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

Weitere Beispiele sind auf GitHub verfügbar.

Modifizierer für Netzwerkregeln

Die Modifikatoren der Netzwerkregeln haben ihre Grenzen: Einige von ihnen können in MV3 nicht oder nur mit Einschränkungen implementiert werden.

Weitere Details zu den Einschränkungen finden Sie auf GitHub. Weitere Informationen zu Modifikatoren finden Sie in unserer Wissensdatenbank.