5.2.25 beta
Pre-releaseAdGuard Browser Extension v5.2 is here with a ton of updates that significantly enhance usability. You’ll find the full changelog below, but here are the standout features we’re most excited about.
Migrating to the User Scripts API
The User Scripts API is a set of browser-provided functions and capabilities that allow extensions to run custom JavaScript scripts on web pages. These are often used to modify or enhance websites in ways that aren’t originally provided by the website itself.
With the shift to Chrome’s Manifest V3, many older methods of injecting scripts are limited or delayed. However, there is an exception for the User Scripts API, but for injecting code, the user must enable either the developer mode (for Chrome versions prior to 138) or the Allow User Scripts toggle (for Chrome version 138 and more recent ones). By migrating AdGuard Browser Extension to the User Scripts API, we give the extension a more reliable and secure method of injecting scripts into web pages at an optimal time. This maintains compatibility with advanced filtering and customization features and allows us to bring back custom filters and the ability to use JavaScript rules in user rules.
Design improvements
We’ve redesigned the blocking pages in the MV2 extension and added them to the MV3 one. Now, when a blocking rule with the $document
modifier is triggered, you’ll see a clearer, more informative warning page. Also, if you’re about to visit a potentially dangerous website, the MV2 extension now greets you with a redesigned safe browsing warning that is easier to understand and act on.
And finally — good news for everyone! We’ve enhanced accessibility for visually impaired users, making sure AdGuard is inclusive and easy to use for more people.
Changelog
Improvements
- Blocking page for requests blocked by
$document
rules in MV3 - Added support for Chrome’s User Scripts API that allows more reliable script injection in MV3
- Send last filter update time during issue reporting #3055
- Added ability to exit editor by pressing the Escape keyboard button #2333.
- Added сompatibility of
$header
modifier with$match-case
and$third-party
modifiers in MV2 #2942 - Added
zip
andcrx
artifacts for the extension builds #3163, #2488 - Restored support for custom filters thanks to the User Scripts API
- Updated blocking pages in MV2 extension for Browsing Security and for web pages blocked by
$document
rules - Improved accessibility for visually impaired users #3035, #2315, #2332
- Removed AdGuard DNS filter and AdGuard Annoyances filter as deprecated
- Allowed to specify attributes without value in selector for HTML filtering rules tsurlfilter#147
- Increased file size limit to 10MB for
$replace
rules in Firefox #3192 - Updated @adguard/dnr-rulesets to v3.1.3
- Updated @adguard/filters-downloader to v2.4.2
- Updated @adguard/assistant to v4.3.74
AGTree (A tool for working with adblock filter lists)
- Updated @adguard/agtree to v3.2.1
AdGuard Logger (A tool for logging from AdGuard extensions)
- Updated @adguard/logger to v2.0.0
Scriptlets (JavaScript enhancement for filtering rules)
- Updated @adguard/scriptlets to v2.2.7
TSUrlFilter (AdGuard Browser Extension filtering engine)
- Updated @adguard/tsurlfilter to v3.4.2
TSWebExtension (Library wrapper for Browser API and TSUrlFilter)
- Updated @adguard/tswebextension to v3.2.4
Fixes
- Cursor moves to the end when saving user rules #3145
- Cannot maximize Filtering log in Firefox for Windows #2464
- Unable to paste text into user rules input field on Android #3061
- Invalid HTML rule selectors are breaking website loading #2646, #2826
- Stealth mode’s Hide Referer from third parties option may break some websites #2839
- Filtering log: Resizing the right panel selects its contents #2305
- Types of the blocked requests are not displayed in the popup (Firefox for Android) #3157
- Switching to the Statistics tab shifts the Actions and Statistics buttons (Edge for Android) #3158
- Filtering log: Request details panel is automatically closed when loading a website in another window/tab #2327
- Scriptlet rules are not displayed in the filtering log #3164
- The filtering in Edge’s split screen doesn’t work #2832
- Total blocked popup string translated incorrectly #3204
$replace
rules may break some websites #3122- Missing space in the description of AdGuard German filter in the
de
locale #3216 - OOM (Out of Memory) errors may occur when applying too many patches in a row in MV2 #3230
- File size limit too low for
$replace
rules in Firefox #3192 - Attributes without value are not allowed for HTML filtering rules tsurlfilter#147
- Firefox extension doesn’t launch on browser startup #3189