Mirrors/uBlock
1
0
Fork 0
mirror of https://github.com/gorhill/uBlock.git synced 2024-11-16 15:33:38 +01:00
Code Issues Releases Wiki Activity

Updated Static filter syntax (markdown)

Raymond Hill 2024-09-21 09:54:31 -04:00
parent 75e1633b1e
commit 6c469a36d6
1 changed files with 13 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
Static-filter-syntax.md

@ -978,8 +978,7 @@ See <https://adguard.com/kb/general/ad-filtering/create-own-filters/#replace-mod
#### `uritransform`
New in [1.52.3b12](https://github.com/gorhill/uBlock/commit/2e4525fe3c509a636fc67776cd728819f54a7de6) as `urltransform`.
Renamed in [1.54.1b8](https://github.com/gorhill/uBlock/commit/cdc5e89f52242f465fdcdb84b9e040992b9cf07c) to `uritransform`.
Candidate for deprecation, avoid usage. To be further discussed.
Can only be used in a trusted-source origin.
@ -989,6 +988,11 @@ See <https://adguard.com/kb/general/ad-filtering/create-own-filters/#urltransfor
[Documentation to be completed]
<details><summary>Technical notes</summary>
New in [1.52.3b12](https://github.com/gorhill/uBlock/commit/2e4525fe3c509a636fc67776cd728819f54a7de6) as `urltransform`.
Renamed in [1.54.1b8](https://github.com/gorhill/uBlock/commit/cdc5e89f52242f465fdcdb84b9e040992b9cf07c) to `uritransform`.
***
#### `urlskip`
@ -1029,21 +1033,20 @@ more than one directive, example:
||example.com/path/to/tracker$urlskip=?url ?to
```
The above filter will cause navigation to `https://example.com/path/to/tracker?url=https%3A%2F%2Fexample.org%2Fpath%2Fto%2Ftracker%3Fto%3Dhttps%253A%252F%252Fgithub.com%252F` to automatically bypass navigation to `example.com` & `example.org`and navigate directly to `https://github.com/`.
The above filter will cause navigation to `https://example.com/path/to/tracker?url=https%3A%2F%2Fexample.org%2Fpath%2Fto%2Ftracker%3Fto%3Dhttps%253A%252F%252Fgithub.com%252F` to automatically bypass navigation to `example.com` & `example.org` and navigate directly to `https://github.com/`.
_Note:_ No skip will occur if not all extraction directives can be fulfilled in URL, example URL:
`https://example.com/path/to/tracker?url=https%3A%2F%2Fexample.org%2Fpath%2Fto%2Ftracker`.
<br>More extraction capabilities may be added in the future. In the future we might want to add base64-decoding or regex extraction (`=?url base64`), so a separator is needed for the sake of extending the syntax in the future, a space is a good choice since it's never meant to appear in a URL.
Related issues:
- [Add queryjump to redirect url](https://github.com/uBlockOrigin/uBlock-issues/issues/3206)
- [Implement `$queryjump` for static network filter](https://github.com/uBlockOrigin/uBlock-issues/issues/2693)
- [[Enhancement] Add option to *automatically* visit embedded URLs w/o tracker](https://github.com/uBlockOrigin/uBlock-issues/issues/1784)
_Note:_ No skip will occur if not all extraction directives can be fulfilled in a given URL. For example, `https://example.com/path/to/tracker?url=https%3A%2F%2Fexample.org%2Fpath%2Fto%2Ftracker` won't be skipped by the filter above because the `?to` step can't be fulfilled.
<details><summary>Technical notes</summary>
First commit in [1.59.1b22](https://github.com/gorhill/uBlock/commit/266ec4894b).
Related issues:
- [Add queryjump to redirect url](https://github.com/uBlockOrigin/uBlock-issues/issues/3206)
- [Implement `$queryjump` for static network filter](https://github.com/uBlockOrigin/uBlock-issues/issues/2693)
- [[Enhancement] Add option to *automatically* visit embedded URLs w/o tracker](https://github.com/uBlockOrigin/uBlock-issues/issues/1784)
</details>
***