From 0a8f3bacdd680823365f7693828acb692c0030fd Mon Sep 17 00:00:00 2001 From: gorhill Date: Mon, 8 Sep 2014 07:15:48 -0700 Subject: [PATCH] Created Filter syntax extensions (markdown) --- Filter-syntax-extensions.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 Filter-syntax-extensions.md diff --git a/Filter-syntax-extensions.md b/Filter-syntax-extensions.md new file mode 100644 index 0000000..b1c540a --- /dev/null +++ b/Filter-syntax-extensions.md @@ -0,0 +1,11 @@ +µBlock supports most of [Adblock Plus filter syntax](https://adblockplus.org/en/filter-cheatsheet). However µBlock does not support some very specific case, and added its own extensions to ABP filter syntax. + +#### Not supported + +**Regular expression-based filters:** may add according to demand, but if ever I add support for regex-based filters, I will support only for regexes which can be tokenized, or which are specific to a hostname, i.e. regexes which can be implemented in an efficient way. + +#### Extended syntax + +**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 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`. + +**The `important` net filter option:** The important filter option, `important`, means to ignore all _allow_ filters. 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 net _allow_ filters. Another example: `||twitter.com^$important,third-party`. Etc. \ No newline at end of file