diff --git a/Static-filter-syntax.md b/Static-filter-syntax.md index 9b6664e..38448d8 100644 --- a/Static-filter-syntax.md +++ b/Static-filter-syntax.md @@ -149,9 +149,13 @@ uBO 1.14.23b3+ only. The purpose of HTML filters is to remove elements from a document _before_ it is parsed by the browser. +The syntax is similar to that of cosmetic filters, except that you must prefix your selector (CSS or procedural) with the character `^`: + example.com##^.badstuff example.com##^script:has-text(7c9e3a5d51cdacfc) +These HTML filters will cause the elements matching the selectors to be **removed from the streamed response data**, such that the browser will never know of their existence once it parses the modified response data. This makes it a powerful tool in uBO's arsenal. + Currently only supported on Firefox 57+. With the introduction of HTML filtering, the `script:contains(...)` is now deprecated and internally converted into an equivalent `##^script:has-text(...)` HTML filter. The result is essentially the same: to prevent the execution of specific inline script tags in a main HTML document. See [_"Inline script tag filtering"_](https://github.com/gorhill/uBlock/wiki/Inline-script-tag-filtering) for further documentation.