issue_674: how to debug rules in AdGuard for Chrome MV3 #700

105th · 2025-05-27T20:32:57Z

No description provided.

Copilot

Pull Request Overview

This PR updates the documentation for debugging rules in the AdGuard Browser Extension for Chrome MV3. It replaces Yarn with pnpm in various commands, adds instructions for using the @adguard/dnr-rulesets watch mode for faster rule development, and clarifies the renaming of the old beta MV2 extension.

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
docs/adguard-browser-extension/solving-problems/debug-rules.md	Replaced Yarn commands with pnpm and added detailed instructions to use the watch mode for DNR rulesets.
docs/adguard-browser-extension/mv3-version.md	Updated the text regarding the renaming of the old beta extension.

Copilot · 2025-05-27T20:33:13Z

docs/adguard-browser-extension/solving-problems/debug-rules.md


    ![Reload extension](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/reload_extension.png)
+
+1. If you see an ❗ mark - it means that assumed rule (which we calculated with our tsurlfilter engine, which performed applying rules in MV2) and actually applied rule (from which we converted to DNR rule) are not the same. And this can be a problem of conversion. <br/> Otherwise, if assumed and applied rules are the same - only applied rule, in raw text and declarative rule views, will be shown.


[nitpick] Consider rephrasing the explanation regarding the ❗ mark for improved clarity; breaking it into shorter sentences might help readers better understand the conversion issue.

Suggested change

1. If you see an ❗ mark - it means that assumed rule (which we calculated with our tsurlfilter engine, which performed applying rules in MV2) and actually applied rule (from which we converted to DNR rule) are not the same. And this can be a problem of conversion. <br/> Otherwise, if assumed and applied rules are the same - only applied rule, in raw text and declarative rule views, will be shown.

1. If you see an exclamation mark, it means the assumed rule (calculated by our tsurlfilter engine using MV2 rules) and the applied rule (converted to a DNR rule) are different. This can be a problem of conversion.

Otherwise, if assumed and applied rules are the same, only applied rule, in raw text and declarative rule views, will be shown.

windsurf-bot · 2025-05-27T20:33:22Z

docs/adguard-browser-extension/solving-problems/debug-rules.md


    ![Reload extension](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/reload_extension.png)
+
+1. If you see an ❗ mark - it means that assumed rule (which we calculated with our tsurlfilter engine, which performed applying rules in MV2) and actually applied rule (from which we converted to DNR rule) are not the same. And this can be a problem of conversion. <br/> Otherwise, if assumed and applied rules are the same - only applied rule, in raw text and declarative rule views, will be shown.


The HTML entity <br/> at the end of the file should be replaced with the markdown equivalent (two spaces followed by a newline or an empty line) for better compatibility and readability across different markdown renderers.

github-actions · 2025-05-27T20:41:21Z

Preview was deployed to: https://pull-request-700.kb-adg.pages.dev/

slavaleleka · 2025-05-27T22:50:44Z

docs/adguard-browser-extension/mv3-version.md

 The **beta version of MV3** will still be available in the [Chrome Web Store](https://chromewebstore.google.com/detail/adguard-adblocker-mv3-exp/apjcbfpjihpedihablmalmbbhjpklbdf).

-The old beta extension will be renamed to [**AdGuard Ad Blocker MV2**](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and will be supported until Google phases it out.
+The old beta extension was renamed to [**AdGuard Ad Blocker MV2**](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and will be supported until Google phases it out.


Suggested change

The old beta extension was renamed to [**AdGuard Ad Blocker MV2**](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and will be supported until Google phases it out.

The old beta extension was renamed to [**AdGuard Ad Blocker MV2**](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and may no longer be supported by Google.

Suggested change

The old beta extension was renamed to [**AdGuard Ad Blocker MV2**](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and will be supported until Google phases it out.

The old beta extension has been renamed to [**AdGuard Ad Blocker MV2**](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and may no longer be supported by Google.

el-termikael · 2025-05-28T07:22:31Z

docs/adguard-browser-extension/mv3-version.md

 The **beta version of MV3** will still be available in the [Chrome Web Store](https://chromewebstore.google.com/detail/adguard-adblocker-mv3-exp/apjcbfpjihpedihablmalmbbhjpklbdf).

-The old beta extension will be renamed to [**AdGuard Ad Blocker MV2**](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and will be supported until Google phases it out.
+The old beta extension was renamed to [**AdGuard Ad Blocker MV2**](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and will be supported until Google phases it out.


Suggested change

The old beta extension was renamed to [**AdGuard Ad Blocker MV2**](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and will be supported until Google phases it out.

The old beta extension has been renamed to [**AdGuard Ad Blocker MV2**](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and may no longer be supported by Google.

el-termikael · 2025-05-28T07:23:19Z

docs/adguard-browser-extension/solving-problems/debug-rules.md

 ## How to debug rules

-1. Find and modify the rule you need in the `./Extension/filters/chromium-mv3` directory in the `.txt` files.
+For faster development of DNR rulesets, you can use `@adguard/dnr-rulesets` watch mode, which will automatically rebuild rulesets whenever filter files change:


Suggested change

For faster development of DNR rulesets, you can use `@adguard/dnr-rulesets` watch mode, which will automatically rebuild rulesets whenever filter files change:

To speed up the development of DNR rulesets, use the `@adguard/dnr-rulesets` watch mode. This mode automatically rebuilds rulesets whenever filter files change:

el-termikael · 2025-05-28T07:24:01Z

docs/adguard-browser-extension/solving-problems/debug-rules.md

+For faster development of DNR rulesets, you can use `@adguard/dnr-rulesets` watch mode, which will automatically rebuild rulesets whenever filter files change:

-1. Convert the rules from txt to declarative form:
+1. First, build the extension once (just skip, if you did it in the "How to build extension" section):


Suggested change

1. First, build the extension once (just skip, if you did it in the "How to build extension" section):

1. First, build the extension (skip this step if you already did so in the *How to build extension* section):

el-termikael · 2025-05-28T07:24:55Z

docs/adguard-browser-extension/solving-problems/debug-rules.md

+        ./build/dev/chrome-mv3/filters/declarative
    ```

+1. Now, whenever you modify filter files, the DNR rulesets will be automatically rebuilt without having to rebuild the entire extension.


Suggested change

1. Now, whenever you modify filter files, the DNR rulesets will be automatically rebuilt without having to rebuild the entire extension.

Now, whenever you modify filter files, the DNR rulesets will rebuild automatically, so you won’t have to rebuild the entire extension.

el-termikael · 2025-05-28T07:26:31Z

docs/adguard-browser-extension/solving-problems/debug-rules.md


    ![Reload extension](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/reload_extension.png)
+
+1. If you see an ❗ mark - it means that assumed rule (which we calculated with our tsurlfilter engine, which performed applying rules in MV2) and actually applied rule (from which we converted to DNR rule) are not the same. And this can be a problem of conversion. <br/> Otherwise, if assumed and applied rules are the same - only applied rule, in raw text and declarative rule views, will be shown.


Suggested change

1. If you see an ❗ mark - it means that assumed rule (which we calculated with our tsurlfilter engine, which performed applying rules in MV2) and actually applied rule (from which we converted to DNR rule) are not the same. And this can be a problem of conversion. <br/> Otherwise, if assumed and applied rules are the same - only applied rule, in raw text and declarative rule views, will be shown.

1. If you see an exclamation mark, it means the assumed rule (calculated by our tsurlfilter engine using MV2 rules) and the applied rule (converted to a DNR rule) are different. This can be a problem of conversion.

Otherwise, if assumed and applied rules are the same, only applied rule, in raw text and declarative rule views, will be shown.

github-actions · 2025-05-28T07:29:30Z

Preview was deployed to: https://pull-request-700.kb-adg.pages.dev/

github-actions · 2025-05-28T18:58:15Z

Preview was deployed to: https://pull-request-700.kb-adg.pages.dev/

github-actions · 2025-05-29T17:51:54Z

Preview was deployed to: https://pull-request-700.kb-adg.pages.dev/

github-actions · 2025-06-04T12:10:04Z

Preview was deployed to: https://pull-request-700.kb-adg.pages.dev/

…tering rules

Co-authored-by: Slava <[email protected]> Co-authored-by: Helen <[email protected]>

Co-authored-by: Helen <[email protected]>

github-actions · 2025-07-15T12:32:44Z

Preview was deployed to: https://pull-request-700.kb-adg.pages.dev/

github-actions · 2025-07-15T12:33:25Z

Preview was deployed to: https://pull-request-700.kb-adg.pages.dev/

github-actions · 2025-08-05T11:48:41Z

Preview was deployed to: https://pull-request-700.kb-adg.pages.dev/

kurrx · 2025-08-05T12:02:44Z

docs/adguard-browser-extension/solving-problems/debug-rules.md

+If you see an exclamation mark in the filtering log, it means the assumed rule (calculated by the engine) and the applied rule (converted to DNR) are different. Otherwise, only the applied rule (in DNR and text ways) will be shown.

-    ![Reload extension](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/reload_extension.png)
+##### <a name="dev-technical-info-about-debug-commands"></a> Technical information about commands


@105th is this section needs to be added?

github-actions · 2025-08-06T02:59:49Z

Preview was deployed to: https://pull-request-700.kb-adg.pages.dev/

issue_674: how to debug rules in AdGuard for Chrome MV3

3f5d30e

105th requested review from SeverAnna, Copilot, el-termikael and slavaleleka May 27, 2025 20:32

Copilot AI reviewed May 27, 2025

View reviewed changes

windsurf-bot bot reviewed May 27, 2025

View reviewed changes

slavaleleka reviewed May 27, 2025

View reviewed changes

slavaleleka approved these changes May 27, 2025

View reviewed changes

Merge branch 'master' into fix/issue_674

34d3bda

el-termikael reviewed May 28, 2025

View reviewed changes

slavaleleka approved these changes May 28, 2025

View reviewed changes

fixes

90caea3

105th requested a review from el-termikael May 28, 2025 18:50

el-termikael approved these changes May 29, 2025

View reviewed changes

105th added 2 commits May 29, 2025 20:38

fix

c696d08

fixed lint errors

af81fe7

SeverAnna approved these changes May 30, 2025

View reviewed changes

Merge branch 'master' into fix/issue_674

ac9aa7c

anyakushin and others added 6 commits July 15, 2025 15:23

Add description for attributes without value in selector for html fil…

a6a6f5c

…tering rules

Better English

097d427

Co-authored-by: Slava <[email protected]> Co-authored-by: Helen <[email protected]>

Specify minimal CoreLibs version supporting optional value in selector

808fe8d

Apply suggested

cb3ae52

Co-authored-by: Helen <[email protected]>

describe the extension compatibility

9ee69db

fix compatibility section grammar

5426a57

Co-authored-by: Helen <[email protected]>

Dasha_Bugayova and others added 22 commits July 15, 2025 15:23

fixed the sentence about reproducing the problem

d0be162

Update docs/adguard-for-windows/solving-problems/dump-file.md

56c1f1b

Co-authored-by: Helen <[email protected]>

Update docs/adguard-for-windows/solving-problems/dump-file.md

1826746

Co-authored-by: Helen <[email protected]>

Update docs/adguard-for-windows/solving-problems/dump-file.md

f82af86

Co-authored-by: Helen <[email protected]>

Update docs/adguard-for-windows/solving-problems/dump-file.md

d904b61

Co-authored-by: Helen <[email protected]>

Update docs/adguard-for-windows/solving-problems/dump-file.md

e54a9ce

Co-authored-by: Helen <[email protected]>

fixed

e0766da

automatically update translations

7e6db73

Update screenshot

ec32e40

Update user-scripts-api.md

8adfabf

Update user-scripts-api.md

133bcab

Update docs/adguard-browser-extension/user-scripts-api.md

99b0ffb

Co-authored-by: Helen <[email protected]>

Update docs/adguard-browser-extension/user-scripts-api.md

28d010e

Co-authored-by: Helen <[email protected]>

Update docs/adguard-browser-extension/user-scripts-api.md

9b62ddd

Co-authored-by: Helen <[email protected]>

Update docs/adguard-browser-extension/user-scripts-api.md

fd43a23

Co-authored-by: Helen <[email protected]>

Update docs/adguard-browser-extension/user-scripts-api.md

c3ab855

Co-authored-by: Helen <[email protected]>

Update user-scripts-api.md

0e5f775

fix wording in Tracking filter rules stats

4468483

delete space

7dd0786

automatically update translations

914a8fe

new description

2bdc6f4

Merge branch 'master' into fix/issue_674

4be3b33

updated command syntax

47a42ce

kurrx self-requested a review August 5, 2025 12:02

kurrx reviewed Aug 5, 2025

View reviewed changes

Merge branch 'master' into fix/issue_674

6640044


		![Reload extension](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/reload_extension.png)

		1. If you see an ❗ mark - it means that assumed rule (which we calculated with our tsurlfilter engine, which performed applying rules in MV2) and actually applied rule (from which we converted to DNR rule) are not the same. And this can be a problem of conversion. <br/> Otherwise, if assumed and applied rules are the same - only applied rule, in raw text and declarative rule views, will be shown.

-. If you see an ❗ mark - it means that assumed rule (which we calculated with our tsurlfilter engine, which performed applying rules in MV2) and actually applied rule (from which we converted to DNR rule) are not the same. And this can be a problem of conversion. <br/> Otherwise, if assumed and applied rules are the same - only applied rule, in raw text and declarative rule views, will be shown.
+. If you see an exclamation mark, it means the assumed rule (calculated by our tsurlfilter engine using MV2 rules) and the applied rule (converted to a DNR rule) are different. This can be a problem of conversion.
+Otherwise, if assumed and applied rules are the same, only applied rule, in raw text and declarative rule views, will be shown.

	The old beta extension was renamed to [AdGuard Ad Blocker MV2](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and will be supported until Google phases it out.
	The old beta extension was renamed to [AdGuard Ad Blocker MV2](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and may no longer be supported by Google.

	The old beta extension was renamed to [AdGuard Ad Blocker MV2](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and will be supported until Google phases it out.
	The old beta extension has been renamed to [AdGuard Ad Blocker MV2](https://chromewebstore.google.com/detail/adguard-adblocker-beta/gfggjaccafhcbfogfkogggoepomehbjl) and may no longer be supported by Google.

	For faster development of DNR rulesets, you can use `@adguard/dnr-rulesets` watch mode, which will automatically rebuild rulesets whenever filter files change:
	To speed up the development of DNR rulesets, use the `@adguard/dnr-rulesets` watch mode. This mode automatically rebuilds rulesets whenever filter files change:

	1. First, build the extension once (just skip, if you did it in the "How to build extension" section):
	1. First, build the extension (skip this step if you already did so in the How to build extension section):

	1. Now, whenever you modify filter files, the DNR rulesets will be automatically rebuilt without having to rebuild the entire extension.
	Now, whenever you modify filter files, the DNR rulesets will rebuild automatically, so you won’t have to rebuild the entire extension.

issue_674: how to debug rules in AdGuard for Chrome MV3 #700

Are you sure you want to change the base?

issue_674: how to debug rules in AdGuard for Chrome MV3 #700

Uh oh!

Conversation

105th commented May 27, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Copilot AI May 27, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

windsurf-bot bot May 27, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented May 27, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented May 28, 2025

Uh oh!

github-actions bot commented May 28, 2025

Uh oh!

github-actions bot commented May 29, 2025

Uh oh!

github-actions bot commented Jun 4, 2025

Uh oh!

github-actions bot commented Jul 15, 2025

Uh oh!

github-actions bot commented Jul 15, 2025

Uh oh!

github-actions bot commented Aug 5, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Aug 6, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

11 participants