Mirrors/uBlock
1
0
Fork 0
mirror of https://github.com/gorhill/uBlock.git synced 2024-09-05 18:49:39 +02:00
Code Issues Releases Wiki Activity

Specific-generic

gwarser 2020-03-06 20:06:25 +01:00
parent 43b36dbf75
commit 6a9021bed0
1 changed files with 25 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
Static-filter-syntax.md

@ -312,7 +312,7 @@ Static extended filters are all of the form:
The most common type of static extended filters are cosmetic filters, also known as "element hiding filters" in Adblock Plus. The most common type of static extended filters are cosmetic filters, also known as "element hiding filters" in Adblock Plus.
### Entity #### Entity
All static extended filters can be declared to apply to a specific _entity_. For example: All static extended filters can be declared to apply to a specific _entity_. For example:
@ -324,6 +324,30 @@ Examples: `google.*` will apply to all similar Google domain names: `google.com
Since the base domain name is used to derive the name of the "entity", `google.evil.biz` would **not** match `google.*`. Since the base domain name is used to derive the name of the "entity", `google.evil.biz` would **not** match `google.*`.
#### Specific-generic
New in [1.24.5rc0](https://github.com/gorhill/uBlock/commit/3fab7bfdb4f892f3d33159fd53ccf1d5342a090a).
A specific cosmetic filter of the following form...
*##.selector
... will be unconditionally injected into all web pages, whereas a cosmetic filter of the form...
##.selector
... would be injected only when uBO's DOM surveyor finds at least one matching element in a web page.
The new specific-generic form will also be disabled when a web page is subject to a `generichide` exception filter, since the filter is essentially a generic one -- the only difference from the usual generic form is that the filter is injected unconditionally instead of through the DOM surveyor.
Specific-generic cosmetic filters will NOT be discarded when checking the "Ignore generic cosmetic filters" option in the "Filter lists" pane -- since the purpose of this option is primarily to disable the DOM surveyor.
Specific-generic cosmetic filters should be used parcimoniously and only when using a normal specific filter is really impractical.
Related issue: [#803](https://github.com/uBlockOrigin/uBlock-issues/issues/803).
### Cosmetic filters ### Cosmetic filters
#### Procedural cosmetic filters #### Procedural cosmetic filters