Skip to content

Add support for regular expressions in $app modifier #714

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

SelYui
Copy link

@SelYui SelYui commented Jun 26, 2025

This PR updates the $app modifier documentation to include support for regular expressions
AdguardTeam/CoreLibs#1906

Add support for regular expressions in `$app` modifier
@SelYui SelYui requested review from sfionov and slavaleleka June 26, 2025 14:04

The `$app` modifier supports combining plain app names, negated app names, and regular expressions in the same rule.

- `||baddomain.com^$app=org.example.app|~org.example.excluded|/org\.example\.[a-z]+/` — applies to `org.example.app`, to all matching `org.example.[a-z]+` apps, and excludes `org.example.excluded`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A negation and a non-negated expression cannot be in the same expression, because ~ essentially matches "everything except", and can only be combined with other ~ expressions to expand that "except". Otherwise, it leads to too many possible interpretations.

You can use regular expressions in the `$app` modifier by enclosing them in forward slashes `/.../`. This allows for more flexible matching — for example, targeting a group of apps from the same publisher or matching complex patterns.

- `||baddomain.com^$app=/org\.example\.[a-z0-9_]+/` — applies to all apps whose package name starts with `org.example` (e.g. `org.example.app1`, `org.example.utility`, etc.).
- `||baddomain.com^$app=/^org\.example\.app$|^org\.example\.[ab].*/` — applies to `org.example.app` and to any app whose package starts with `org.example.a` or `org.example.b`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

$ and , should be escaped in modifiers, since unescaped $ means modifiers start, and , is modifiers separator.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants