diff --git a/Static-filter-syntax.md b/Static-filter-syntax.md index f3f8eee..1d9f746 100644 --- a/Static-filter-syntax.md +++ b/Static-filter-syntax.md @@ -978,8 +978,7 @@ See Technical notes + +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`. +_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. + +
Technical notes + +First commit in [1.59.1b22](https://github.com/gorhill/uBlock/commit/266ec4894b). -
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) -
Technical notes - -First commit in [1.59.1b22](https://github.com/gorhill/uBlock/commit/266ec4894b).
***