Mirrors
/
uBlock
mirror of https://github.com/gorhill/uBlock.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Updated Filter syntax extensions (markdown)

gorhill 2014-09-25 06:35:50 -07:00
parent 2c93e2f5df
commit 1cd775df97
1 changed files with 11 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
Filter-syntax-extensions.md

@ -9,11 +9,20 @@
µBlock extends Adblock Plus filter syntax.
#### Network filters
**The `important` network filter option:** The important filter option, `important`, means to ignore all _exception_ filters (those prefixed with `@@`). It applies only to net _block_ filters. The `important` option will allow you to block with 100% certainty specific net requests. Example: `||google-analytics.com^$important,third-party` will block all net requests to `google-analytics.com`, disregarding any existing network _exception_ filters. Another example: `||twitter.com^$important,third-party`. Etc.
**The `important` network filter option:** The important filter option, `important`, means to ignore all _exception_ filters (those prefixed with `@@`).
It applies only to net _block_ filters. The `important` option will allow you to block with 100% certainty specific net requests.
Example: `||google-analytics.com^$important,third-party` will block all net requests to `google-analytics.com`, disregarding any existing network _exception_ filters. Another example: `||twitter.com^$important,third-party`. Etc.
**The `inline-script` network filter option:** To specifically disable inline script tags in a main
page: `||example.com^$inline-script`.
#### Cosmetic filters
**Entity-based cosmetic filters:** Filters which are to be applied to a specific _entity_. An _entity_ is defined as follow: a formal domain name with the Public Suffix part replaced by a wildcard. Examples: `google.*` will apply to all similar Google domain names: `google.com`, `google.com.br`, `google.ca`, `google.co.uk`, etc. Another example: `facebook.*` will apply to all similar Facebook domain names: `facebook.com`, `facebook.net`.
**Entity-based cosmetic filters:** Filters which are to be applied to a specific _entity_.
An _entity_ is defined as follow: a formal domain name with the Public Suffix part replaced by a wildcard.
Examples: `google.*` will apply to all similar Google domain names: `google.com`, `google.com.br`, `google.ca`, `google.co.uk`, etc. Another example: `facebook.*` will apply to all similar Facebook domain names: `facebook.com`, `facebook.net`.