mirror of https://github.com/gorhill/uBlock.git
Relative links everywhere else
parent
8e9f4954a6
commit
6721554db3
|
@ -20,20 +20,20 @@ Do these design choices really cause uBO to be _"inferior in capabilities"_ comp
|
||||||
Features | ABP | uBO
|
Features | ABP | uBO
|
||||||
-------- | :---: | :---:
|
-------- | :---: | :---:
|
||||||
**network filtering**
|
**network filtering**
|
||||||
[multi-stage filtering engine](https://github.com/gorhill/uBlock/wiki/Overview-of-uBlock's-network-filtering-engine)<br><sup>ability for users to easily override filters in 3rd-party filter lists on a per-site basis</sup> | | yes
|
[multi-stage filtering engine](./Overview-of-uBlock's-network-filtering-engine)<br><sup>ability for users to easily override filters in 3rd-party filter lists on a per-site basis</sup> | | yes
|
||||||
`@@...$document` | yes | [no](https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#not-supported)
|
`@@...$document` | yes | [no](./Static-filter-syntax#not-supported)
|
||||||
can read hosts files | | yes
|
can read hosts files | | yes
|
||||||
`inline-script`<br><sup>to prevent execution of inline javascript</sup> | [no](https://issues.adblockplus.org/ticket/748) | [yes](https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#inline-script)
|
`inline-script`<br><sup>to prevent execution of inline javascript</sup> | [no](https://issues.adblockplus.org/ticket/748) | [yes](./Static-filter-syntax#inline-script)
|
||||||
`important`<br><sup>to be able to override exception filters</sup> | | [yes](https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#important)
|
`important`<br><sup>to be able to override exception filters</sup> | | [yes](./Static-filter-syntax#important)
|
||||||
`popunder` | [no](https://issues.adblockplus.org/ticket/2095) | yes
|
`popunder` | [no](https://issues.adblockplus.org/ticket/2095) | yes
|
||||||
`redirect`<br><sup>to redirect to local resources, key to privacy and to counter anti-blockers</sup> | | yes
|
`redirect`<br><sup>to redirect to local resources, key to privacy and to counter anti-blockers</sup> | | yes
|
||||||
`csp=`<br><sup>see [rationale](https://github.com/gorhill/uBlock/issues/1930#issuecomment-301055346)</sup> | | yes
|
`csp=`<br><sup>see [rationale](https://github.com/gorhill/uBlock/issues/1930#issuecomment-301055346)</sup> | | yes
|
||||||
`badfilter`<br><sup>to disable an existing filter</sup> | | yes
|
`badfilter`<br><sup>to disable an existing filter</sup> | | yes
|
||||||
[strict blocking](https://github.com/gorhill/uBlock/wiki/Strict-blocking) | | yes
|
[strict blocking](./Strict-blocking) | | yes
|
||||||
rule-based filtering<br><sup>firewall-like or URL-based rules with corresponding point-and-click UI</sup> | | yes
|
rule-based filtering<br><sup>firewall-like or URL-based rules with corresponding point-and-click UI</sup> | | yes
|
||||||
behind-the-scene<br><sup>uBO's logger reports behind-the-scene request, filtering is opt-in</sup> | | [yes](https://github.com/gorhill/uBlock/wiki/Behind-the-scene-network-requests)
|
behind-the-scene<br><sup>uBO's logger reports behind-the-scene request, filtering is opt-in</sup> | | [yes](./Behind-the-scene-network-requests)
|
||||||
**cosmetic filtering**
|
**cosmetic filtering**
|
||||||
entity-based filters | | [yes](https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#entity-based-cosmetic-filters)
|
entity-based filters | | [yes](./Static-filter-syntax#entity-based-cosmetic-filters)
|
||||||
`-abp-properties` | yes | [no](https://github.com/gorhill/uBlock/issues/139)
|
`-abp-properties` | yes | [no](https://github.com/gorhill/uBlock/issues/139)
|
||||||
`:has` | ~~[not yet](https://issues.adblockplus.org/ticket/2360)~~ yes (`:-abp-has`) | yes
|
`:has` | ~~[not yet](https://issues.adblockplus.org/ticket/2360)~~ yes (`:-abp-has`) | yes
|
||||||
`:has-text` | [yes](https://issues.adblockplus.org/ticket/5249) (`-abp-contains`) | yes
|
`:has-text` | [yes](https://issues.adblockplus.org/ticket/5249) (`-abp-contains`) | yes
|
||||||
|
@ -42,26 +42,26 @@ entity-based filters | | [yes](https://github.com/gorhill/uBlock/wiki/Static
|
||||||
`script:contains` | | yes
|
`script:contains` | | yes
|
||||||
`script:inject`<br><sup>key to counter anti-blockers</sup> | | yes
|
`script:inject`<br><sup>key to counter anti-blockers</sup> | | yes
|
||||||
**HTML filtering**
|
**HTML filtering**
|
||||||
Ability to modify response data on the fly<br><sup>WebExtensions uBO 1.15+</sup> | | [yes](https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#html-filters)
|
Ability to modify response data on the fly<br><sup>WebExtensions uBO 1.15+</sup> | | [yes](./Static-filter-syntax#html-filters)
|
||||||
**privacy**
|
**privacy**
|
||||||
pro-user default settings<br><sup>uBO is not monetized, it's under no pressure to [compromise](https://adblockplus.org/forum/viewtopic.php?f=17&t=50215) on pro-user interests</sup> | | yes
|
pro-user default settings<br><sup>uBO is not monetized, it's under no pressure to [compromise](https://adblockplus.org/forum/viewtopic.php?f=17&t=50215) on pro-user interests</sup> | | yes
|
||||||
disable pre-fetching | | [yes](https://github.com/gorhill/uBlock/wiki/Dashboard:-Settings#disable-pre-fetching)
|
disable pre-fetching | | [yes](./Dashboard:-Settings#disable-pre-fetching)
|
||||||
disable hyperlink auditing | | [yes](https://github.com/gorhill/uBlock/wiki/Dashboard:-Settings#disable-hyperlink-auditing)
|
disable hyperlink auditing | | [yes](./Dashboard:-Settings#disable-hyperlink-auditing)
|
||||||
disable local IP addresses leakage through WebRTC | | [yes](https://github.com/gorhill/uBlock/wiki/Dashboard:-Settings#prevent-webrtc-from-leaking-local-ip-address)
|
disable local IP addresses leakage through WebRTC | | [yes](./Dashboard:-Settings#prevent-webrtc-from-leaking-local-ip-address)
|
||||||
block CSP reports | | [yes](https://github.com/gorhill/uBlock/wiki/Dashboard:-Settings#block-csp-reports)
|
block CSP reports | | [yes](./Dashboard:-Settings#block-csp-reports)
|
||||||
**other features**
|
**other features**
|
||||||
pre-compilation of filter lists for fast loading of filters | | [yes](https://github.com/gorhill/uBlock/wiki/Launch-and-filter-lists-load-performance)
|
pre-compilation of filter lists for fast loading of filters | | [yes](./Launch-and-filter-lists-load-performance)
|
||||||
"acceptable ads" | yes | [no](https://github.com/gorhill/uBlock/blob/master/MANIFESTO.md)
|
"acceptable ads" | yes | [no](https://github.com/gorhill/uBlock/blob/master/MANIFESTO.md)
|
||||||
disable everywhere | yes |
|
disable everywhere | yes |
|
||||||
count filter hits | yes, [disabled by default](https://issues.adblockplus.org/ticket/5298) | [no](https://github.com/gorhill/uBlock/issues/1353)
|
count filter hits | yes, [disabled by default](https://issues.adblockplus.org/ticket/5298) | [no](https://github.com/gorhill/uBlock/issues/1353)
|
||||||
ability to globally ignore generic cosmetic filters<br><sup>useful for low-performance mobile devices</sup> | | yes
|
ability to globally ignore generic cosmetic filters<br><sup>useful for low-performance mobile devices</sup> | | yes
|
||||||
cloud storage | Firefox only | yes
|
cloud storage | Firefox only | yes
|
||||||
point-and-click firewall-like filtering<br><sup>allows for [relax](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-medium-mode) or [strict](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-hard-mode) default-deny approach</up> | | yes
|
point-and-click firewall-like filtering<br><sup>allows for [relax](./Blocking-mode:-medium-mode) or [strict](./Blocking-mode:-hard-mode) default-deny approach</up> | | yes
|
||||||
logger | per-page | [unified](https://github.com/gorhill/uBlock/wiki/The-logger)
|
logger | per-page | [unified](./The-logger)
|
||||||
point-and-click per-site no-popups | | [yes](https://github.com/gorhill/uBlock/wiki/Per-site-switches#no-popups)
|
point-and-click per-site no-popups | | [yes](./Per-site-switches#no-popups)
|
||||||
point-and-click per site no-cosmetic-filtering | | [yes](https://github.com/gorhill/uBlock/wiki/Per-site-switches#no-cosmetic-filtering)
|
point-and-click per site no-cosmetic-filtering | | [yes](./Per-site-switches#no-cosmetic-filtering)
|
||||||
point-and-click per site no-large-media-elements | | [yes](https://github.com/gorhill/uBlock/wiki/Per-site-switches#no-large-media-elements)
|
point-and-click per site no-large-media-elements | | [yes](./Per-site-switches#no-large-media-elements)
|
||||||
point-and-click per site no-remote-fonts | | [yes](https://github.com/gorhill/uBlock/wiki/Per-site-switches#no-remote-fonts)
|
point-and-click per site no-remote-fonts | | [yes](./Per-site-switches#no-remote-fonts)
|
||||||
integrated element picker | Chromium-based browsers only | [yes](https://github.com/gorhill/uBlock/wiki/Element-picker)
|
integrated element picker | Chromium-based browsers only | [yes](./Element-picker)
|
||||||
element zapper | | [yes](https://github.com/gorhill/uBlock/wiki/Element-zapper)
|
element zapper | | [yes](./Element-zapper)
|
||||||
easy backup/restore of all settings | Firefox only | yes
|
easy backup/restore of all settings | Firefox only | yes
|
||||||
|
|
|
@ -1,10 +1,10 @@
|
||||||
[Back to Wiki home](https://github.com/gorhill/uBlock/wiki)
|
[Back to Wiki home](./)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
The _"Advanced settings"_ page contains settings which are experimental, or which are of interest to advanced users who want more control over how uBO behaves internally.
|
The _"Advanced settings"_ page contains settings which are experimental, or which are of interest to advanced users who want more control over how uBO behaves internally.
|
||||||
|
|
||||||
These advanced settings can be easily accessed only when the setting [_"I am an advanced user"_](https://github.com/gorhill/uBlock/wiki/Advanced-user-features) in the _Settings_ pane in the dashboard is checked, but will persist and work even when the setting [_"I am an advanced user"_](https://github.com/gorhill/uBlock/wiki/Advanced-user-features) is not checked:
|
These advanced settings can be easily accessed only when the setting [_"I am an advanced user"_](./Advanced-user-features) in the _Settings_ pane in the dashboard is checked, but will persist and work even when the setting [_"I am an advanced user"_](./Advanced-user-features) is not checked:
|
||||||
|
|
||||||
![Click on the _cogs_ icon](https://cloud.githubusercontent.com/assets/585534/20042797/2800dcd4-a44e-11e6-9bc8-a5e0c960262c.png)
|
![Click on the _cogs_ icon](https://cloud.githubusercontent.com/assets/585534/20042797/2800dcd4-a44e-11e6-9bc8-a5e0c960262c.png)
|
||||||
|
|
||||||
|
@ -179,7 +179,7 @@ If set to `info`, prints debug messages to the browser console.
|
||||||
|
|
||||||
Default: `false`.
|
Default: `false`.
|
||||||
|
|
||||||
If set to `true`, [`debugger;` statement](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/debugger) will be inserted just before [scriptlet](https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#scriptlet-injection) code
|
If set to `true`, [`debugger;` statement](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/debugger) will be inserted just before [scriptlet](./Static-filter-syntax#scriptlet-injection) code
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -257,7 +257,7 @@ Default: `120` seconds.
|
||||||
|
|
||||||
uBO 1.17.3b4 and above.
|
uBO 1.17.3b4 and above.
|
||||||
|
|
||||||
Controls duration of the [Strict blocking](https://github.com/gorhill/uBlock/wiki/Strict-blocking) "Temporarily" bypass.
|
Controls duration of the [Strict blocking](./Strict-blocking) "Temporarily" bypass.
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to _Dynamic filtering: default-deny_](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering:-default-deny)
|
[Back to _Dynamic filtering: default-deny_](./Dynamic-filtering:-default-deny)
|
||||||
|
|
||||||
**Important notes:**
|
**Important notes:**
|
||||||
|
|
||||||
|
@ -10,7 +10,7 @@ Because of this (and other reasons which will eventually come to light), startin
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
The filtering of behind-the-scene network request is available to [advanced users](https://github.com/gorhill/uBlock/wiki/Behind-the-scene-network-requests).
|
The filtering of behind-the-scene network request is available to [advanced users](./Behind-the-scene-network-requests).
|
||||||
|
|
||||||
### What are behind-the-scene network requests
|
### What are behind-the-scene network requests
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to _Blocking mode_](https://github.com/gorhill/uBlock/wiki/Blocking-mode)
|
[Back to _Blocking mode_](./Blocking-mode)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -13,7 +13,7 @@ This mode is suitable for those who are concerned about reducing their privacy e
|
||||||
##### Characteristics
|
##### Characteristics
|
||||||
|
|
||||||
- Low likelihood of web pages being broken.
|
- Low likelihood of web pages being broken.
|
||||||
- Web pages should load somewhat faster compared to the [_very easy mode_](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-very-easy-mode).
|
- Web pages should load somewhat faster compared to the [_very easy mode_](./Blocking-mode:-very-easy-mode).
|
||||||
|
|
||||||
##### How to enable this mode
|
##### How to enable this mode
|
||||||
|
|
||||||
|
@ -38,4 +38,4 @@ You can significantly augment the blocking power in easy mode by merely enabling
|
||||||
- some may cause too much web page breakage.
|
- some may cause too much web page breakage.
|
||||||
- some may result in some network requests to unexpectedly become unblocked ([example](https://github.com/gorhill/uBlock/issues/357)).
|
- some may result in some network requests to unexpectedly become unblocked ([example](https://github.com/gorhill/uBlock/issues/357)).
|
||||||
|
|
||||||
Another even better way to augment blocking power in _easy_ mode is to enable _"I am an advanced user"_ from the _Settings_ pane in the dashboard, and block specific 3rd parties using [dynamic filtering](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering) -- i.e. essentially using dynamic filtering in default-allow mode. For example, one could choose to globally block `facebook.com` and `facebook.net` in order to prevent Facebook from being able to track you wherever you go, except on Facebook. Globally blocking ubiquitous hostnames except on their respective web sites is a very easy way to reduce significantly privacy exposure.
|
Another even better way to augment blocking power in _easy_ mode is to enable _"I am an advanced user"_ from the _Settings_ pane in the dashboard, and block specific 3rd parties using [dynamic filtering](./Dynamic-filtering) -- i.e. essentially using dynamic filtering in default-allow mode. For example, one could choose to globally block `facebook.com` and `facebook.net` in order to prevent Facebook from being able to track you wherever you go, except on Facebook. Globally blocking ubiquitous hostnames except on their respective web sites is a very easy way to reduce significantly privacy exposure.
|
||||||
|
|
|
@ -4,7 +4,7 @@
|
||||||
|
|
||||||
Roughly similar to using Adblock Plus with many filter lists + NoScript with 1st-party scripts/frames automatically whitelisted + RequestPolicy with 1st-party resources automatically whitelisted.
|
Roughly similar to using Adblock Plus with many filter lists + NoScript with 1st-party scripts/frames automatically whitelisted + RequestPolicy with 1st-party resources automatically whitelisted.
|
||||||
|
|
||||||
Blocking-wise, this is a small leap from [medium mode](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-medium-mode). This mode will however lead to a higher likelihood of broken web sites, and thus will likely require intervention the first time you visit a site, since even passive 3rd-party resources (i.e. images, css) are blocked with this mode.
|
Blocking-wise, this is a small leap from [medium mode](./Blocking-mode:-medium-mode). This mode will however lead to a higher likelihood of broken web sites, and thus will likely require intervention the first time you visit a site, since even passive 3rd-party resources (i.e. images, css) are blocked with this mode.
|
||||||
|
|
||||||
This mode will block all 3rd parties by default, so it keeps privacy exposure to 3rd parties to a minimum.
|
This mode will block all 3rd parties by default, so it keeps privacy exposure to 3rd parties to a minimum.
|
||||||
|
|
||||||
|
@ -14,7 +14,7 @@ This mode will block all 3rd parties by default, so it keeps privacy exposure to
|
||||||
![toolbar button badge](https://user-images.githubusercontent.com/585534/62878220-abb12200-bcf6-11e9-8c0b-79f5f2ed96c5.png)
|
![toolbar button badge](https://user-images.githubusercontent.com/585534/62878220-abb12200-bcf6-11e9-8c0b-79f5f2ed96c5.png)
|
||||||
<br>Starting with [v1.21.7b5](https://github.com/gorhill/uBlock/commit/7ff750eaf6007bdea4e843d3314fc7275b1ce945), a red badge on uBlock₀ toolbar button indicates activation of the hard mode.
|
<br>Starting with [v1.21.7b5](https://github.com/gorhill/uBlock/commit/7ff750eaf6007bdea4e843d3314fc7275b1ce945), a red badge on uBlock₀ toolbar button indicates activation of the hard mode.
|
||||||
|
|
||||||
With a single click, it is possible to toggle the hard mode into the [medium mode](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-medium-mode): it's just a matter of assigning a local noop rule to the _3rd-party_ cell.
|
With a single click, it is possible to toggle the hard mode into the [medium mode](./Blocking-mode:-medium-mode): it's just a matter of assigning a local noop rule to the _3rd-party_ cell.
|
||||||
|
|
||||||
##### Characteristics
|
##### Characteristics
|
||||||
|
|
||||||
|
@ -48,10 +48,10 @@ _My rules_ pane:
|
||||||
|
|
||||||
With few clicks, you can easily fall back into lesser blocking modes, if ever you do not have the willingness to figure the necessary rules for a given site.
|
With few clicks, you can easily fall back into lesser blocking modes, if ever you do not have the willingness to figure the necessary rules for a given site.
|
||||||
|
|
||||||
Fall back into [medium mode](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-medium-mode) for the current site:
|
Fall back into [medium mode](./Blocking-mode:-medium-mode) for the current site:
|
||||||
- set a local noop rule for the _3rd-party_ cell.
|
- set a local noop rule for the _3rd-party_ cell.
|
||||||
|
|
||||||
Fall back into [easy mode](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-easy-mode) for the current site:
|
Fall back into [easy mode](./Blocking-mode:-easy-mode) for the current site:
|
||||||
- set a local noop rule for the _3rd-party_ cell.
|
- set a local noop rule for the _3rd-party_ cell.
|
||||||
- set a local noop rule for the _3rd-party script_ cell.
|
- set a local noop rule for the _3rd-party script_ cell.
|
||||||
- Optionally, set a local noop rule for the _3rd-party frames_ cell.
|
- Optionally, set a local noop rule for the _3rd-party frames_ cell.
|
||||||
|
|
|
@ -4,9 +4,9 @@
|
||||||
|
|
||||||
Roughly similar to using Adblock Plus with many filter lists + NoScript with 1st-party scripts/frames automatically whitelisted. Unlike NoScript however, you can easily point-and-click to block/allow scripts _on a per-site basis_.
|
Roughly similar to using Adblock Plus with many filter lists + NoScript with 1st-party scripts/frames automatically whitelisted. Unlike NoScript however, you can easily point-and-click to block/allow scripts _on a per-site basis_.
|
||||||
|
|
||||||
Blocking-wise, this is one significant leap from [easy mode](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-easy-mode). However, be ready to accept that you will have to un-break websites, though at a lesser rate than [hard mode](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-hard-mode), since passive 3rd-party resources (i.e. images, css) are not blocked in medium mode.
|
Blocking-wise, this is one significant leap from [easy mode](./Blocking-mode:-easy-mode). However, be ready to accept that you will have to un-break websites, though at a lesser rate than [hard mode](./Blocking-mode:-hard-mode), since passive 3rd-party resources (i.e. images, css) are not blocked in medium mode.
|
||||||
|
|
||||||
This is where you start to use [dynamic filtering](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering), a feature available only when you tell uBlock Origin that you are an [advanced user](https://github.com/gorhill/uBlock/wiki/Advanced-user-features). Be sure to read [the guide](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering) before, it is assumed that you understand well how dynamic filtering works in order to use medium mode effectively.
|
This is where you start to use [dynamic filtering](./Dynamic-filtering), a feature available only when you tell uBlock Origin that you are an [advanced user](./Advanced-user-features). Be sure to read [the guide](./Dynamic-filtering) before, it is assumed that you understand well how dynamic filtering works in order to use medium mode effectively.
|
||||||
|
|
||||||
![3rd-party scripts are blocked by default](https://user-images.githubusercontent.com/585534/62878866-f41d0f80-bcf7-11e9-890e-c90438d7f982.png)
|
![3rd-party scripts are blocked by default](https://user-images.githubusercontent.com/585534/62878866-f41d0f80-bcf7-11e9-890e-c90438d7f982.png)
|
||||||
<br>3rd-party scripts and frames are blocked by default.
|
<br>3rd-party scripts and frames are blocked by default.
|
||||||
|
@ -18,7 +18,7 @@ Using medium mode will significantly improve your browser performance, and simil
|
||||||
|
|
||||||
##### Characteristics
|
##### Characteristics
|
||||||
|
|
||||||
- Web pages will load significantly faster compared to the [_easy mode_](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-easy-mode).
|
- Web pages will load significantly faster compared to the [_easy mode_](./Blocking-mode:-easy-mode).
|
||||||
- Your privacy exposure will be significantly reduced compared to easy mode.
|
- Your privacy exposure will be significantly reduced compared to easy mode.
|
||||||
- You no longer depend mostly on 3rd-party filter lists to dictate what is blocked or not.
|
- You no longer depend mostly on 3rd-party filter lists to dictate what is blocked or not.
|
||||||
- The static filter lists are still used to mop up whatever network requests are not blocked in this mode -- so double protection.
|
- The static filter lists are still used to mop up whatever network requests are not blocked in this mode -- so double protection.
|
||||||
|
@ -47,7 +47,7 @@ _My rules_ pane:
|
||||||
|
|
||||||
With one click or two, you can easily fall back into lesser blocking mode, if ever you do not have the willingness to figure the necessary rules for a given site.
|
With one click or two, you can easily fall back into lesser blocking mode, if ever you do not have the willingness to figure the necessary rules for a given site.
|
||||||
|
|
||||||
To fall back into [easy mode](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-easy-mode):
|
To fall back into [easy mode](./Blocking-mode:-easy-mode):
|
||||||
- Set a local noop rule for the _3rd-party script_ cell:<br>
|
- Set a local noop rule for the _3rd-party script_ cell:<br>
|
||||||
![3rd-party scripts allowed](https://user-images.githubusercontent.com/585534/62879000-33e3f700-bcf8-11e9-8929-c49541df8e7c.png)
|
![3rd-party scripts allowed](https://user-images.githubusercontent.com/585534/62879000-33e3f700-bcf8-11e9-8929-c49541df8e7c.png)
|
||||||
- Set a local noop rule for the _3rd-party frames_ cell (optional, as blocking 3rd-party frames is less likely to break websites):<br>
|
- Set a local noop rule for the _3rd-party frames_ cell (optional, as blocking 3rd-party frames is less likely to break websites):<br>
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
[Back to _Blocking mode_](https://github.com/gorhill/uBlock/wiki/Blocking-mode)
|
[Back to _Blocking mode_](./Blocking-mode)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
Nightmare mode is when you block everything, except the main document. All secondary resources are blocked. As a result, most sites are broken. I personally advise against using this mode, since there is no real advantages from the [hard mode](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-hard-mode). If you want to use uBlock Origin in this mode, you are probably better off using [uMatrix](https://github.com/gorhill/uMatrix) or [Policeman](https://github.com/futpib/policeman), which will give you a higher granular control over network requests than what uBlock allows you.
|
Nightmare mode is when you block everything, except the main document. All secondary resources are blocked. As a result, most sites are broken. I personally advise against using this mode, since there is no real advantages from the [hard mode](./Blocking-mode:-hard-mode). If you want to use uBlock Origin in this mode, you are probably better off using [uMatrix](https://github.com/gorhill/uMatrix) or [Policeman](https://github.com/futpib/policeman), which will give you a higher granular control over network requests than what uBlock allows you.
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to _Blocking mode_](https://github.com/gorhill/uBlock/wiki/Blocking-mode)
|
[Back to _Blocking mode_](./Blocking-mode)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
- Back to [Wiki home](https://github.com/gorhill/uBlock/wiki)
|
- Back to [Wiki home](./)
|
||||||
- Back to [Dashboard](https://github.com/gorhill/uBlock/wiki/Dashboard)
|
- Back to [Dashboard](./Dashboard)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -31,7 +31,7 @@ The import/export of cloud storage data in a pane works strictly at the UI level
|
||||||
|
|
||||||
If ever an export operation causes the cloud storage capacity limit to be reached, typically the cloud storage providers will refuse the operation, and the data on the cloud storage will be left unchanged. This is what I have observed with Chromium-based browsers.
|
If ever an export operation causes the cloud storage capacity limit to be reached, typically the cloud storage providers will refuse the operation, and the data on the cloud storage will be left unchanged. This is what I have observed with Chromium-based browsers.
|
||||||
|
|
||||||
If you do not have a syncing account with your browser vendor, I have observed that the cloud storage feature can still be used as a local clipboard to save a pane settings. Might be convenient sometimes, but please do not use cloud storage as a replacement for [uBlock Origin's backup feature](https://github.com/gorhill/uBlock/wiki/Dashboard:-Settings#backuprestore-section). It is recommended you back up your settings regularly, this is especially true for those who have extensive custom static filters, custom rules, whitelist directives.
|
If you do not have a syncing account with your browser vendor, I have observed that the cloud storage feature can still be used as a local clipboard to save a pane settings. Might be convenient sometimes, but please do not use cloud storage as a replacement for [uBlock Origin's backup feature](./Dashboard:-Settings#backuprestore-section). It is recommended you back up your settings regularly, this is especially true for those who have extensive custom static filters, custom rules, whitelist directives.
|
||||||
|
|
||||||
> ***
|
> ***
|
||||||
> **Important:** Some browsers offer the ability to use a passphrase for their sync feature, in order to enable end-to-end encryption of the data stored for sync purpose ([example](https://support.google.com/chrome/answer/1181035)). It is strongly suggested to make use of such passphrase.
|
> **Important:** Some browsers offer the ability to use a passphrase for their sync feature, in order to enable end-to-end encryption of the data stored for sync purpose ([example](https://support.google.com/chrome/answer/1181035)). It is strongly suggested to make use of such passphrase.
|
||||||
|
|
|
@ -60,4 +60,4 @@ Adblock Plus:<br>
|
||||||
|
|
||||||
Observations:
|
Observations:
|
||||||
|
|
||||||
Last time I ran this benchmark [was on Chromium 34 64-bit](https://github.com/gorhill/uBlock/wiki/%C2%B5Block-vs.-ABP:-efficiency-compared#added-memory-footprint-to-web-pages), and it does appear that Chromium 37 is causing web pages to consume more memory -- reference result went from ~17 MB to ~22 MB.
|
Last time I ran this benchmark [was on Chromium 34 64-bit](./%C2%B5Block-vs.-ABP:-efficiency-compared#added-memory-footprint-to-web-pages), and it does appear that Chromium 37 is causing web pages to consume more memory -- reference result went from ~17 MB to ~22 MB.
|
||||||
|
|
|
@ -2,7 +2,7 @@ Just a page to collect my counterarguments when I spot something which I believe
|
||||||
|
|
||||||
#### Who cares about efficiency, I have 8 GB
|
#### Who cares about efficiency, I have 8 GB
|
||||||
|
|
||||||
I heard this argument so often from apologists of bloated software that I decided to give the counterargument its [own page](https://github.com/gorhill/uBlock/wiki/Who-cares-about-efficiency,-I-have-8-GB-and%7Cor-a-quad-core-CPU).
|
I heard this argument so often from apologists of bloated software that I decided to give the counterargument its [own page](./Who-cares-about-efficiency,-I-have-8-GB-and%7Cor-a-quad-core-CPU).
|
||||||
|
|
||||||
#### Just use a hosts file
|
#### Just use a hosts file
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to Wiki home](https://github.com/gorhill/uBlock/wiki)
|
[Back to Wiki home](./)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
|
|
@ -1,9 +1,9 @@
|
||||||
- Back to [Wiki home](https://github.com/gorhill/uBlock/wiki)
|
- Back to [Wiki home](./)
|
||||||
- Back to [Dashboard](https://github.com/gorhill/uBlock/wiki/Dashboard)
|
- Back to [Dashboard](./Dashboard)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
The _Filter lists_ pane is where you subscribe to filter lists. The filter lists to which you subscribe will feed uBlock Origin's [static filtering engine](https://github.com/gorhill/uBlock/wiki/Overview-of-uBlock's-network-filtering-engine:-details#static-filtering).
|
The _Filter lists_ pane is where you subscribe to filter lists. The filter lists to which you subscribe will feed uBlock Origin's [static filtering engine](./Overview-of-uBlock's-network-filtering-engine:-details#static-filtering).
|
||||||
|
|
||||||
The picture below shows uBlock Origin's default selection of filter lists. You can add more, or remove some of the filter lists already selected by default (for reference, most other blockers have only EasyList selected).
|
The picture below shows uBlock Origin's default selection of filter lists. You can add more, or remove some of the filter lists already selected by default (for reference, most other blockers have only EasyList selected).
|
||||||
|
|
||||||
|
@ -17,7 +17,7 @@ uBlock Origin discards duplicate filters, so the number of filters used within a
|
||||||
|
|
||||||
When you hover the cursor over the clock icon of a filter list, a tooltip will tell you when the list was last updated. If you click the clock icon, uBO will mark the list as out-of-date. Lists which are out of date will be automatically updated in the background eventually when you check the option _"Auto update filter lists"_. You can force out-of-date lists to be immediately updated by clicking _"Update now"_.
|
When you hover the cursor over the clock icon of a filter list, a tooltip will tell you when the list was last updated. If you click the clock icon, uBO will mark the list as out-of-date. Lists which are out of date will be automatically updated in the background eventually when you check the option _"Auto update filter lists"_. You can force out-of-date lists to be immediately updated by clicking _"Update now"_.
|
||||||
|
|
||||||
Related: [_"Launch and filter lists load performance"_](https://github.com/gorhill/uBlock/wiki/Launch-and-filter-lists-load-performance).
|
Related: [_"Launch and filter lists load performance"_](./Launch-and-filter-lists-load-performance).
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -38,7 +38,7 @@ When a filter list has been updated using a newer version from its remote locati
|
||||||
|
|
||||||
![](https://cloud.githubusercontent.com/assets/585534/25020937/4a6a55b6-205e-11e7-94ac-9c51697f9f90.gif)
|
![](https://cloud.githubusercontent.com/assets/585534/25020937/4a6a55b6-205e-11e7-94ac-9c51697f9f90.gif)
|
||||||
|
|
||||||
Note: "uBlock filters" entry is special - forcing update of this filter list, will also update additional resources when possible (library of resources used by [Scriptlet injection](https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#scriptlet-injection), allowed to be updated on Chromium browser and develpment buils).
|
Note: "uBlock filters" entry is special - forcing update of this filter list, will also update additional resources when possible (library of resources used by [Scriptlet injection](./Static-filter-syntax#scriptlet-injection), allowed to be updated on Chromium browser and develpment buils).
|
||||||
|
|
||||||
##### Purge all caches
|
##### Purge all caches
|
||||||
|
|
||||||
|
@ -64,4 +64,4 @@ This is a collection of various filter lists, grouped by purpose. To use a speci
|
||||||
|
|
||||||
You can import custom 3rd-party filter lists: place check mark next to "Import..." in the "Custom" section and paste the URL of where a filter lists can be fetched from in the text area that appears. These custom filter lists will be also automatically updated on a regular basis.
|
You can import custom 3rd-party filter lists: place check mark next to "Import..." in the "Custom" section and paste the URL of where a filter lists can be fetched from in the text area that appears. These custom filter lists will be also automatically updated on a regular basis.
|
||||||
|
|
||||||
On some specific web pages, it is possible to subscribe to a 3rd-party filter list by simply clicking on a link to the filter list. There is such a page for uBlock Origin: [Filter lists from around the web](https://github.com/gorhill/uBlock/wiki/Filter-lists-from-around-the-web).
|
On some specific web pages, it is possible to subscribe to a 3rd-party filter list by simply clicking on a link to the filter list. There is such a page for uBlock Origin: [Filter lists from around the web](./Filter-lists-from-around-the-web).
|
||||||
|
|
|
@ -1,5 +1,5 @@
|
||||||
- Back to [Wiki home](https://github.com/gorhill/uBlock/wiki)
|
- Back to [Wiki home](./)
|
||||||
- Back to [Dashboard](https://github.com/gorhill/uBlock/wiki/Dashboard)
|
- Back to [Dashboard](./Dashboard)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -21,13 +21,13 @@ Currently mostly useful for users who checked _"I am an advanced user"_ (see bel
|
||||||
|
|
||||||
### I am an advanced user
|
### I am an advanced user
|
||||||
|
|
||||||
If you check this, this will enable [uBlock's dynamic filtering](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering), and the dynamic filtering pane will become available from uBlock's popup UI.
|
If you check this, this will enable [uBlock's dynamic filtering](./Dynamic-filtering), and the dynamic filtering pane will become available from uBlock's popup UI.
|
||||||
|
|
||||||
Unchecking this disables the dynamic filtering. And the dynamic filtering pane in the popup UI will no longer be available.
|
Unchecking this disables the dynamic filtering. And the dynamic filtering pane in the popup UI will no longer be available.
|
||||||
|
|
||||||
_Advanced user_ mode also gives access to the [advanced settings](https://github.com/gorhill/uBlock/wiki/Advanced-settings) (normally hidden), and enables the ability to filter [behind-the-scene network requests](https://github.com/gorhill/uBlock/wiki/Behind-the-scene-network-requests).
|
_Advanced user_ mode also gives access to the [advanced settings](./Advanced-settings) (normally hidden), and enables the ability to filter [behind-the-scene network requests](./Behind-the-scene-network-requests).
|
||||||
|
|
||||||
You should avoid playing with advanced features and settings unless [you understand fully what you are doing](https://github.com/gorhill/uBlock/wiki/Advanced-user-features).
|
You should avoid playing with advanced features and settings unless [you understand fully what you are doing](./Advanced-user-features).
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -111,7 +111,7 @@ The above rule means CSP reports would be blocked on `example.com` when CSP repo
|
||||||
|
|
||||||
## Default behavior
|
## Default behavior
|
||||||
|
|
||||||
Please see: ["Per site switches"](https://github.com/gorhill/uBlock/wiki/Per-site-switches)
|
Please see: ["Per site switches"](./Per-site-switches)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
|
|
@ -4,7 +4,7 @@ See [_"Hyperlink-Auditing aka `<a ping>` and Beacon aka `navigator.sendBeacon()`
|
||||||
|
|
||||||
### Chromium-based browsers
|
### Chromium-based browsers
|
||||||
|
|
||||||
For those browsers, the network requests fired as a result of calling `navigator.sendBeacon()` are sent as [behind-the-scene](https://github.com/gorhill/uBlock/wiki/Behind-the-scene-network-requests) network requests.
|
For those browsers, the network requests fired as a result of calling `navigator.sendBeacon()` are sent as [behind-the-scene](./Behind-the-scene-network-requests) network requests.
|
||||||
|
|
||||||
#### Caveats for browsers based on Chromium version 48 or less
|
#### Caveats for browsers based on Chromium version 48 or less
|
||||||
|
|
||||||
|
|
|
@ -18,7 +18,7 @@ uBlock also support the parsing and enforcing of hosts files -- something which
|
||||||
|
|
||||||
**Short answer:** resources hidden -- in various ways depending on the class of cosmetic filters.
|
**Short answer:** resources hidden -- in various ways depending on the class of cosmetic filters.
|
||||||
|
|
||||||
These filters serve to remove DOM elements from a web page. They have no value privacy-wise, it is essentially to make web page look better by removing unwanted content, which usually cannot be blocked using network filters. Just like ABP, uBlock will hide DOM elements on a web page which match cosmetic filters. uBlock uses a [different method](https://github.com/gorhill/uBlock/wiki/Cosmetic-filtering-in-%C2%B5Block:-version-0.4.0.0-update) than other big-name blockers to hide the DOM elements though.
|
These filters serve to remove DOM elements from a web page. They have no value privacy-wise, it is essentially to make web page look better by removing unwanted content, which usually cannot be blocked using network filters. Just like ABP, uBlock will hide DOM elements on a web page which match cosmetic filters. uBlock uses a [different method](./Cosmetic-filtering-in-%C2%B5Block:-version-0.4.0.0-update) than other big-name blockers to hide the DOM elements though.
|
||||||
|
|
||||||
Different classes of cosmetic filters are applied differently:
|
Different classes of cosmetic filters are applied differently:
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
**TL;DR:** if you worry about uBO's added overhead for non-bloated sites, just [disable cosmetic filtering](https://github.com/gorhill/uBlock/wiki/Per-site-switches#no-cosmetic-filtering) on a per-site basis, it is the optimal approach: this will keep you protected security- and privacy-wise (as far as your filters/rules allow) while minimizing the added overhead.
|
**TL;DR:** if you worry about uBO's added overhead for non-bloated sites, just [disable cosmetic filtering](./Per-site-switches#no-cosmetic-filtering) on a per-site basis, it is the optimal approach: this will keep you protected security- and privacy-wise (as far as your filters/rules allow) while minimizing the added overhead.
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -14,9 +14,9 @@ That said, for web pages where uBO finds nothing or very little to block (let's
|
||||||
|
|
||||||
Disabling uBO for a site to avoid added the overhead is a judgment call to be made by the user, considering many factors:
|
Disabling uBO for a site to avoid added the overhead is a judgment call to be made by the user, considering many factors:
|
||||||
- There is more than just the CPU cycles and memory return to consider with regard to invested overhead: there is also the peace-of-mind return of knowing your blocker is protecting you. There is no guarantee that a nice site will not stop being nice at any given moment, or that a nice site won't ever be hijacked and start to serve bad stuff.
|
- There is more than just the CPU cycles and memory return to consider with regard to invested overhead: there is also the peace-of-mind return of knowing your blocker is protecting you. There is no guarantee that a nice site will not stop being nice at any given moment, or that a nice site won't ever be hijacked and start to serve bad stuff.
|
||||||
- If you use [_medium mode_](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-medium-mode), it does not make much sense to disable uBO since typically this mode is used to also protect against [CSRF](https://en.wikipedia.org/wiki/Cross-site_request_forgery).
|
- If you use [_medium mode_](./Blocking-mode:-medium-mode), it does not make much sense to disable uBO since typically this mode is used to also protect against [CSRF](https://en.wikipedia.org/wiki/Cross-site_request_forgery).
|
||||||
|
|
||||||
There is also another way to reduce the overhead without sacrificing the security/privacy benefits as a result of disabling uBO: just [disable cosmetic filtering](https://github.com/gorhill/uBlock/wiki/Per-site-switches#no-cosmetic-filtering) for nice sites -- this will remove good chunk of overhead while keeping you well protected since network filtering is still fully enabled -- whereas, as hinted by its name, cosmetic filtering offers no protection value.
|
There is also another way to reduce the overhead without sacrificing the security/privacy benefits as a result of disabling uBO: just [disable cosmetic filtering](./Per-site-switches#no-cosmetic-filtering) for nice sites -- this will remove good chunk of overhead while keeping you well protected since network filtering is still fully enabled -- whereas, as hinted by its name, cosmetic filtering offers no protection value.
|
||||||
|
|
||||||
If you are curious about the overhead added by uBO for any given web page, you can use this [page load speed tool](http://www.raymondhill.net/ublock/pageloadspeed.html) (won't work for pages which are not allowed to be embedded into frames), with which you can compare how fast a page load with and without uBO, and with different settings in uBO.
|
If you are curious about the overhead added by uBO for any given web page, you can use this [page load speed tool](http://www.raymondhill.net/ublock/pageloadspeed.html) (won't work for pages which are not allowed to be embedded into frames), with which you can compare how fast a page load with and without uBO, and with different settings in uBO.
|
||||||
|
|
||||||
|
|
|
@ -4,7 +4,7 @@ Dynamic URL filtering became available in uBlock Origin version 0.9.8.0.
|
||||||
|
|
||||||
The primary purpose of dynamic URL filtering ("URL filtering") is as a diagnosis/mitigation tool to fix web page breakage caused by dynamic filtering or static filtering. Secondary purpose of URL filtering is to offer higher granularity than what dynamic filtering can support.
|
The primary purpose of dynamic URL filtering ("URL filtering") is as a diagnosis/mitigation tool to fix web page breakage caused by dynamic filtering or static filtering. Secondary purpose of URL filtering is to offer higher granularity than what dynamic filtering can support.
|
||||||
|
|
||||||
URL filtering has precedence over dynamic filtering and static filtering. See ["Overview of uBlock's network filtering engine"](https://github.com/gorhill/uBlock/wiki/Overview-of-uBlock's-network-filtering-engine) to see where URL filtering fits and to better understand its purpose.
|
URL filtering has precedence over dynamic filtering and static filtering. See ["Overview of uBlock's network filtering engine"](./Overview-of-uBlock's-network-filtering-engine) to see where URL filtering fits and to better understand its purpose.
|
||||||
|
|
||||||
URL filtering is accessible from the logger, i.e. you will create and manage dynamic URL rules through the logger UI, by clicking on the 4th cell in the row specific to the resource for which a rule needs to be created:
|
URL filtering is accessible from the logger, i.e. you will create and manage dynamic URL rules through the logger UI, by clicking on the 4th cell in the row specific to the resource for which a rule needs to be created:
|
||||||
|
|
||||||
|
|
|
@ -8,7 +8,7 @@ Dynamic filtering is targeted toward users who wish to have that additional bit
|
||||||
|
|
||||||
Dynamic filtering is a useful feature security-wise. For example, blocking 3rd-party `<iframe>` by default would have protected users in the case of the [jQuery.com malware attack](http://www.riskiq.com/resources/blog/jquerycom-malware-attack-puts-privileged-enterprise-it-accounts-risk). Disabling inline javascript is also often useful to work around anti-blockers on some sites. Using dynamic filtering can help speed up _significantly_ how fast web pages load.
|
Dynamic filtering is a useful feature security-wise. For example, blocking 3rd-party `<iframe>` by default would have protected users in the case of the [jQuery.com malware attack](http://www.riskiq.com/resources/blog/jquerycom-malware-attack-puts-privileged-enterprise-it-accounts-risk). Disabling inline javascript is also often useful to work around anti-blockers on some sites. Using dynamic filtering can help speed up _significantly_ how fast web pages load.
|
||||||
|
|
||||||
See [examples of usefulness/benefits](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering---examples) of using dynamic filtering.
|
See [examples of usefulness/benefits](./Dynamic-filtering---examples) of using dynamic filtering.
|
||||||
|
|
||||||
Of course, blocking portion of a page may cause page breakage, sometimes benign, sometimes severe. It is up to the user to choose how to make use of this feature.
|
Of course, blocking portion of a page may cause page breakage, sometimes benign, sometimes severe. It is up to the user to choose how to make use of this feature.
|
||||||
|
|
||||||
|
@ -54,4 +54,4 @@ Network requests blocked through dynamic filtering will be reported just as any
|
||||||
|
|
||||||
![Figure 3](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/dynamic-filtering-3.png)
|
![Figure 3](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/dynamic-filtering-3.png)
|
||||||
|
|
||||||
Dynamic filters are always deemed [important](https://github.com/gorhill/uBlock/wiki/Filter-syntax-extensions#network-filters), thus they will show up with the `important` filter option attached to them. When a network request is blocked because of a dynamic filtering default setting, the hostname will be reported as `*`, as seen in the picture above.
|
Dynamic filters are always deemed [important](./Filter-syntax-extensions#network-filters), thus they will show up with the `important` filter option attached to them. When a network request is blocked because of a dynamic filtering default setting, the hostname will be reported as `*`, as seen in the picture above.
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
Dynamic filtering:
|
Dynamic filtering:
|
||||||
|
|
||||||
- [Benefits of blocking 3rd-party `script` and `iframe` tags](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering:-Benefits-of-blocking-3rd-party-script-and-iframe-tags)
|
- [Benefits of blocking 3rd-party `script` and `iframe` tags](./Dynamic-filtering:-Benefits-of-blocking-3rd-party-script-and-iframe-tags)
|
||||||
- [Usefulness of blocking inline `script` tags](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering%3A-Usefulness-of-blocking-inline-script-tags)
|
- [Usefulness of blocking inline `script` tags](./Dynamic-filtering%3A-Usefulness-of-blocking-inline-script-tags)
|
||||||
- [Usefulness of blocking 1st-party `script` tags](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering:-Usefulness-of-blocking-1st-party-script-tags)
|
- [Usefulness of blocking 1st-party `script` tags](./Dynamic-filtering:-Usefulness-of-blocking-1st-party-script-tags)
|
||||||
- [Benefits of blocking 3rd-party `iframe` tags](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering%3A-Benefits-of-blocking-3rd-party-iframe-tags)
|
- [Benefits of blocking 3rd-party `iframe` tags](./Dynamic-filtering%3A-Benefits-of-blocking-3rd-party-iframe-tags)
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to Wiki home](https://github.com/gorhill/uBlock/wiki)
|
[Back to Wiki home](./)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to _Blocking mode_](https://github.com/gorhill/uBlock/wiki/Blocking-mode)
|
[Back to _Blocking mode_](./Blocking-mode)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to _Dynamic filtering_](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering)
|
[Back to _Dynamic filtering_](./Dynamic-filtering)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -44,7 +44,7 @@ You can disengage default-deny for the current site with one click: set the "3rd
|
||||||
![Default-deny](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/df-dd-02.png)<br>
|
![Default-deny](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/df-dd-02.png)<br>
|
||||||
<sup>Default-deny cancelled locally. Notice that the blocking of 3rd-party frames is still in effect: cells with higher precedence won't have their rules overriden by cells with lower precedence.</sup>
|
<sup>Default-deny cancelled locally. Notice that the blocking of 3rd-party frames is still in effect: cells with higher precedence won't have their rules overriden by cells with lower precedence.</sup>
|
||||||
|
|
||||||
This results in default-deny being disengaged for the current site ([The Guardian](http://www.theguardian.com/) in our example), **while** keeping engaged static filtering (_EasyList_, _EasyPrivacy_, etc.). In this particular example, as can be seen in the picture, 3rd-party frames will still be blocked (usually a [good thing privacy- and security-wise](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering:-Benefits-of-blocking-3rd-party-iframe-tags)).
|
This results in default-deny being disengaged for the current site ([The Guardian](http://www.theguardian.com/) in our example), **while** keeping engaged static filtering (_EasyList_, _EasyPrivacy_, etc.). In this particular example, as can be seen in the picture, 3rd-party frames will still be blocked (usually a [good thing privacy- and security-wise](./Dynamic-filtering:-Benefits-of-blocking-3rd-party-iframe-tags)).
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to _Dynamic filtering: default-deny_](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering:-default-deny)
|
[Back to _Dynamic filtering: default-deny_](./Dynamic-filtering:-default-deny)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
|
|
@ -1,8 +1,8 @@
|
||||||
[Back to "Dynamic-filtering"](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering)
|
[Back to "Dynamic-filtering"](./Dynamic-filtering)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
First: Whitelist directives override both dynamic filtering _and_ static filtering. Whitelist directives appear in the [_Whitelist_ pane in the dashboard](https://github.com/gorhill/uBlock/wiki/How-to-whitelist-a-web-site), and they are used to completely disable filtering. The [big blue button in the popup UI](https://github.com/gorhill/uBlock/wiki/Quick-guide:-popup-user-interface#the-large-power-button) is used to easily whitelist the current site/page.
|
First: Whitelist directives override both dynamic filtering _and_ static filtering. Whitelist directives appear in the [_Whitelist_ pane in the dashboard](./How-to-whitelist-a-web-site), and they are used to completely disable filtering. The [big blue button in the popup UI](./Quick-guide:-popup-user-interface#the-large-power-button) is used to easily whitelist the current site/page.
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
|
|
@ -1,8 +1,8 @@
|
||||||
[Back to _Dynamic-filtering_](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering)
|
[Back to _Dynamic-filtering_](./Dynamic-filtering)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
Dynamic filtering pane ([available only to advanced users](https://github.com/gorhill/uBlock/wiki/Advanced-user-features)) can be toggled by clicking on `requests blocked` or `domains connected`:
|
Dynamic filtering pane ([available only to advanced users](./Advanced-user-features)) can be toggled by clicking on `requests blocked` or `domains connected`:
|
||||||
|
|
||||||
![figure 1](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/df-qg-01.png)
|
![figure 1](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/df-qg-01.png)
|
||||||
|
|
||||||
|
@ -48,7 +48,7 @@ Sensible security- and privacy-wise: blocking all 3rd-party frames by default ev
|
||||||
>
|
>
|
||||||
> This means a _block_ dynamic rule will override any existing _allow_ static filters. This means you can block with 100% certainty using dynamic filtering rules. Similarly, an _allow_ dynamic filtering rule will override any existing _block_ static filters, i.e. you can allow with 100% certainty with dynamic filtering (useful to un-break sites broken by some static filters).
|
> This means a _block_ dynamic rule will override any existing _allow_ static filters. This means you can block with 100% certainty using dynamic filtering rules. Similarly, an _allow_ dynamic filtering rule will override any existing _block_ static filters, i.e. you can allow with 100% certainty with dynamic filtering (useful to un-break sites broken by some static filters).
|
||||||
>
|
>
|
||||||
> This may help understand how static and dynamic filtering interact: [Overview of uBlock's network filtering engine](https://github.com/gorhill/uBlock/wiki/Overview-of-uBlock's-network-filtering-engine).
|
> This may help understand how static and dynamic filtering interact: [Overview of uBlock's network filtering engine](./Overview-of-uBlock's-network-filtering-engine).
|
||||||
> ***
|
> ***
|
||||||
|
|
||||||
All embedded 3rd-party frames were blocked on the page. Good. However it appears there was an embedded YouTube video in the article:
|
All embedded 3rd-party frames were blocked on the page. Good. However it appears there was an embedded YouTube video in the article:
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to "Dynamic-filtering"](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering)
|
[Back to "Dynamic-filtering"](./Dynamic-filtering)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to _Blocking mode_](https://github.com/gorhill/uBlock/wiki/Blocking-mode)
|
[Back to _Blocking mode_](./Blocking-mode)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -14,9 +14,9 @@ This is also true for other entity such as Twitter, Google, Disqus, etc.
|
||||||
> Recommended reading: [_Internet Companies: Confusing Consumers for Profit_](https://www.eff.org/deeplinks/2015/10/internet-companies-confusing-consumers-profit) (EFF)
|
> Recommended reading: [_Internet Companies: Confusing Consumers for Profit_](https://www.eff.org/deeplinks/2015/10/internet-companies-confusing-consumers-profit) (EFF)
|
||||||
> ***
|
> ***
|
||||||
|
|
||||||
uBlock Origin's [_dynamic filtering_](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering) can help you foil the ability of ubiquitous servers from building a profile of your browsing habits.
|
uBlock Origin's [_dynamic filtering_](./Dynamic-filtering) can help you foil the ability of ubiquitous servers from building a profile of your browsing habits.
|
||||||
|
|
||||||
Will use Facebook as an example. Facebook will still have the ability to track your browsing habits when using uBlock Origin with its default settings [see benchmark's raw data for [_Easy Mode_](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-easy-mode): notice in the [list of 3rd parties](https://github.com/gorhill/uBlock/wiki/Blocking-mode#easy-mode) how `facebook.net` is ubiquitous].
|
Will use Facebook as an example. Facebook will still have the ability to track your browsing habits when using uBlock Origin with its default settings [see benchmark's raw data for [_Easy Mode_](./Blocking-mode:-easy-mode): notice in the [list of 3rd parties](./Blocking-mode#easy-mode) how `facebook.net` is ubiquitous].
|
||||||
|
|
||||||
First, we block Facebook-related hostnames globally, such that network requests to Facebook servers are blocked _by default, everywhere_ (the first column is for global rules):
|
First, we block Facebook-related hostnames globally, such that network requests to Facebook servers are blocked _by default, everywhere_ (the first column is for global rules):
|
||||||
|
|
||||||
|
@ -54,7 +54,7 @@ This is just an example, the same can be applied to any of the ubiquitous server
|
||||||
|
|
||||||
`block` rules to ubiquitous web sites will easily reduce _significantly_ your privacy exposure.
|
`block` rules to ubiquitous web sites will easily reduce _significantly_ your privacy exposure.
|
||||||
|
|
||||||
Using the above example of blocking Facebook everywhere with the [benchmark result for _Easy mode_](https://github.com/gorhill/uBlock/wiki/Blocking-mode#easy-mode) (uBlock Origin's default mode), the count of 3rd parties would have been decreased from 512 to
|
Using the above example of blocking Facebook everywhere with the [benchmark result for _Easy mode_](./Blocking-mode#easy-mode) (uBlock Origin's default mode), the count of 3rd parties would have been decreased from 512 to
|
||||||
437, an easy way to significantly reduce your privacy exposure with just a few clicks.
|
437, an easy way to significantly reduce your privacy exposure with just a few clicks.
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
|
@ -1,8 +1,8 @@
|
||||||
[Back to "Dynamic-filtering"](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering)
|
[Back to "Dynamic-filtering"](./Dynamic-filtering)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
"Blacklist mode" can be achieved in UBO [Advanced users](https://github.com/gorhill/uBlock/wiki/Advanced-user-features) mode in following way:
|
"Blacklist mode" can be achieved in UBO [Advanced users](./Advanced-user-features) mode in following way:
|
||||||
|
|
||||||
- global allow `all` cell
|
- global allow `all` cell
|
||||||
- "global" = 1st column
|
- "global" = 1st column
|
||||||
|
@ -24,6 +24,6 @@ This will cause the current site to become subjected to static filtering (EasyLi
|
||||||
|
|
||||||
Dynamic filtering disengaged for current site: "gray" means disengage dynamic filtering, but apply static filtering.
|
Dynamic filtering disengaged for current site: "gray" means disengage dynamic filtering, but apply static filtering.
|
||||||
|
|
||||||
Keep in mind cosmetic filtering will still apply, so you may also want to [disable cosmetic filtering everywhere by default](https://github.com/gorhill/uBlock/wiki/Per-site-switches#no-cosmetic-filtering).
|
Keep in mind cosmetic filtering will still apply, so you may also want to [disable cosmetic filtering everywhere by default](./Per-site-switches#no-cosmetic-filtering).
|
||||||
|
|
||||||
In the screenshots above, 3rd-party frames are blocked to remind this is [a good habit in general](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering:-Benefits-of-blocking-3rd-party-iframe-tags), and to illustrate that narrower dynamic rules prevails over more generic ones.
|
In the screenshots above, 3rd-party frames are blocked to remind this is [a good habit in general](./Dynamic-filtering:-Benefits-of-blocking-3rd-party-iframe-tags), and to illustrate that narrower dynamic rules prevails over more generic ones.
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to _Dynamic-filtering_](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering)
|
[Back to _Dynamic-filtering_](./Dynamic-filtering)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -6,12 +6,12 @@ The ability to turned off uBlock everywhere has been requested many times: [#40]
|
||||||
|
|
||||||
I wasn't really planning to provide this functionality as I fail to see why it should be implemented in uBlock when the browsers themselves offer this ability through the disabling of extensions.
|
I wasn't really planning to provide this functionality as I fail to see why it should be implemented in uBlock when the browsers themselves offer this ability through the disabling of extensions.
|
||||||
|
|
||||||
In any case, the ability to "disable" uBlock everywhere is now available [for Advanced users](https://github.com/gorhill/uBlock/wiki/Advanced-user-features), as a side effect of the ability to create a global `allow` rule for all network requests:
|
In any case, the ability to "disable" uBlock everywhere is now available [for Advanced users](./Advanced-user-features), as a side effect of the ability to create a global `allow` rule for all network requests:
|
||||||
|
|
||||||
![Allow everything everywhere](https://user-images.githubusercontent.com/886325/42134019-c298f4ba-7d33-11e8-8bba-f8f20aae8034.png)
|
![Allow everything everywhere](https://user-images.githubusercontent.com/886325/42134019-c298f4ba-7d33-11e8-8bba-f8f20aae8034.png)
|
||||||
|
|
||||||
Though it's more _"allow everything from everywhere"_, it's as good as _"globally turn off uBlock"_. You can revert it by clicking on the eraser button.
|
Though it's more _"allow everything from everywhere"_, it's as good as _"globally turn off uBlock"_. You can revert it by clicking on the eraser button.
|
||||||
|
|
||||||
Keep in mind:
|
Keep in mind:
|
||||||
- [dynamic rule precedence logic](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering:-precedence), which means that the above will work as expected as long as you do not have existing higher precedence rules which override with the global _allow-all_ rule.
|
- [dynamic rule precedence logic](./Dynamic-filtering:-precedence), which means that the above will work as expected as long as you do not have existing higher precedence rules which override with the global _allow-all_ rule.
|
||||||
- cosmetic filtering will still apply, so you may also want to [disable cosmetic filtering everywhere by default](https://github.com/gorhill/uBlock/wiki/Per-site-switches#no-cosmetic-filtering).
|
- cosmetic filtering will still apply, so you may also want to [disable cosmetic filtering everywhere by default](./Per-site-switches#no-cosmetic-filtering).
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to Wiki home](https://github.com/gorhill/uBlock/wiki)
|
[Back to Wiki home](./)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -33,8 +33,8 @@ There may be many different reasons for this.
|
||||||
- If this is a network filter you may need to manually edit the filter to make use of wildcards for the parts of the URL which are variable.
|
- If this is a network filter you may need to manually edit the filter to make use of wildcards for the parts of the URL which are variable.
|
||||||
- If this is a cosmetic filter, you may have to manually craft a better [CSS selector](https://www.w3.org/TR/selectors/#overview). Sometimes this requires observing the surrounding DOM data.
|
- If this is a cosmetic filter, you may have to manually craft a better [CSS selector](https://www.w3.org/TR/selectors/#overview). Sometimes this requires observing the surrounding DOM data.
|
||||||
- Cosmetic filtering is disabled for the site, or globally. There are many ways to disable cosmetic filtering:
|
- Cosmetic filtering is disabled for the site, or globally. There are many ways to disable cosmetic filtering:
|
||||||
- The [per-site cosmetic filtering switch](https://github.com/gorhill/uBlock/wiki/Per-site-switches#no-cosmetic-filtering).
|
- The [per-site cosmetic filtering switch](./Per-site-switches#no-cosmetic-filtering).
|
||||||
- The option [_"Parse and enforce cosmetic filters"_](https://github.com/gorhill/uBlock/wiki/Dashboard:-3rd-party-filters#parse-and-enforce-cosmetic-filters) is un-checked in the [_3rd-party filters_](https://github.com/gorhill/uBlock/wiki/Dashboard:-3rd-party-filters) pane in the dashboard.
|
- The option [_"Parse and enforce cosmetic filters"_](./Dashboard:-3rd-party-filters#parse-and-enforce-cosmetic-filters) is un-checked in the [_3rd-party filters_](./Dashboard:-3rd-party-filters) pane in the dashboard.
|
||||||
- You un-checked _My filters_ in the _3rd-party filters_ pane in the dashboard.
|
- You un-checked _My filters_ in the _3rd-party filters_ pane in the dashboard.
|
||||||
- There is a static filter in one of the 3rd-party filter lists in use which counters your filter.
|
- There is a static filter in one of the 3rd-party filter lists in use which counters your filter.
|
||||||
- Exception cosmetic filters (`#@#`) cancel cosmetic filters (`##`).
|
- Exception cosmetic filters (`#@#`) cancel cosmetic filters (`##`).
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to Wiki home](https://github.com/gorhill/uBlock/wiki)
|
[Back to Wiki home](./)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
|
|
@ -1,3 +1,3 @@
|
||||||
At this point, uBlock Origin does not ship with any experimental features.
|
At this point, uBlock Origin does not ship with any experimental features.
|
||||||
|
|
||||||
The experimental local mirroring feature ([page history](https://github.com/gorhill/uBlock/wiki/Experimental-features/7148ff9bd4e6077aecf00077f7836028c82b5f35#privacy-exposure-reduction-local-mirroring)) has been removed for good. There's a browser extension for Firefox, Chrome, and Opera, which purpose is similar to what local mirroring meant to accomplish. See [Decentraleyes](https://decentraleyes.org), or the corresponding [source code repository](https://git.synz.io/Synzvato/decentraleyes).
|
The experimental local mirroring feature ([page history](./Experimental-features/7148ff9bd4e6077aecf00077f7836028c82b5f35#privacy-exposure-reduction-local-mirroring)) has been removed for good. There's a browser extension for Firefox, Chrome, and Opera, which purpose is similar to what local mirroring meant to accomplish. See [Decentraleyes](https://decentraleyes.org), or the corresponding [source code repository](https://git.synz.io/Synzvato/decentraleyes).
|
||||||
|
|
|
@ -8,8 +8,8 @@ In the unlikelihood you find web pages broken by the _Experimental_ filter list,
|
||||||
|
|
||||||
There are currently two experimental filters, which are block-then-redirect filters, to block the following resources:
|
There are currently two experimental filters, which are block-then-redirect filters, to block the following resources:
|
||||||
|
|
||||||
- `googletagservices.com/tag/js/gpt.js`: Normally [not blocked by EasyPrivacy](https://github.com/gorhill/uBlock/wiki/Blocking-mode#easy-mode).
|
- `googletagservices.com/tag/js/gpt.js`: Normally [not blocked by EasyPrivacy](./Blocking-mode#easy-mode).
|
||||||
- The effect of blocking `googletagservices.com` by default can be appreciated by looking at how often it occurred as a 3rd-party in [_Easy_ blocking mode](https://github.com/gorhill/uBlock/wiki/Blocking-mode) (which is default uBO settings).
|
- The effect of blocking `googletagservices.com` by default can be appreciated by looking at how often it occurred as a 3rd-party in [_Easy_ blocking mode](./Blocking-mode) (which is default uBO settings).
|
||||||
- Specifically, this would bring the number of 3rd parties hit during the benchmark for the _Easy_ blocking mode from 512 to 466.
|
- Specifically, this would bring the number of 3rd parties hit during the benchmark for the _Easy_ blocking mode from 512 to 466.
|
||||||
- The neutered script should also further speed up page load speed.
|
- The neutered script should also further speed up page load speed.
|
||||||
- `www.google-analytics.com/ga.js`: Normally blocked by uBO, but blocking this resource has sometimes led to page breakage, so exception filters have been required. By forcing a redirect to a neutered version, the goal is to reduce page breakage while avoiding the need to create an exception filter for some sites ([example](https://github.com/gorhill/uBlock/issues/1081#issuecomment-165501960)).
|
- `www.google-analytics.com/ga.js`: Normally blocked by uBO, but blocking this resource has sometimes led to page breakage, so exception filters have been required. By forcing a redirect to a neutered version, the goal is to reduce page breakage while avoiding the need to create an exception filter for some sites ([example](https://github.com/gorhill/uBlock/issues/1081#issuecomment-165501960)).
|
||||||
|
|
|
@ -59,7 +59,7 @@ If you still want to use uBO/legacy, a volunteer created an extension to enable
|
||||||
|
|
||||||
[Issue #2795](https://github.com/gorhill/uBlock/issues/2795) will be a collection of [bugzilla.mozilla.org](https://bugzilla.mozilla.org/) issues which currently affect the uBO/webext specifically.
|
[Issue #2795](https://github.com/gorhill/uBlock/issues/2795) will be a collection of [bugzilla.mozilla.org](https://bugzilla.mozilla.org/) issues which currently affect the uBO/webext specifically.
|
||||||
|
|
||||||
Be sure to create backups of your uBO settings, if the transition from uBO/legacy to uBO/webext fails, you can always just restore all your settings from the backup file (see [_Settings_ pane in the dashboard for the backup/restore features](https://github.com/gorhill/uBlock/wiki/Dashboard:-Settings#backuprestore-section)).
|
Be sure to create backups of your uBO settings, if the transition from uBO/legacy to uBO/webext fails, you can always just restore all your settings from the backup file (see [_Settings_ pane in the dashboard for the backup/restore features](./Dashboard:-Settings#backuprestore-section)).
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
**Note:** Results have been updated with latest Firefox 52 and Chrome 59. Previous benchmarks:
|
**Note:** Results have been updated with latest Firefox 52 and Chrome 59. Previous benchmarks:
|
||||||
- Firefox 41/Chromium 45: [see revision](https://github.com/gorhill/uBlock/wiki/Firefox-version:-benchmarking-memory-footprint/0e022fdbeff93ee22890533ad33f8dd07c4c1efa)
|
- Firefox 41/Chromium 45: [see revision](./Firefox-version:-benchmarking-memory-footprint/0e022fdbeff93ee22890533ad33f8dd07c4c1efa)
|
||||||
- Firefox 35/Chromium 39: [see revision](https://github.com/gorhill/uBlock/wiki/Firefox-version:-benchmarking-memory-footprint/4dddff63af59f69b6301a82a790619099e2ac2ef)
|
- Firefox 35/Chromium 39: [see revision](./Firefox-version:-benchmarking-memory-footprint/4dddff63af59f69b6301a82a790619099e2ac2ef)
|
||||||
|
|
||||||
#### Setup
|
#### Setup
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
Back to [Static filter syntax](https://github.com/gorhill/uBlock/wiki/Static-filter-syntax).
|
Back to [Static filter syntax](./Static-filter-syntax).
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -66,7 +66,7 @@ uBlock Origin 1.2.0 introduces a new way to block **specific** inline script tag
|
||||||
|
|
||||||
example.com##script:contains(...)
|
example.com##script:contains(...)
|
||||||
|
|
||||||
Please note that with the introduction of [HTML filtering](https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#html-filters), the `script:contains(...)` syntax is now deprecated and internally converted into an equivalent `##^script:has-text(...)` HTML filter.
|
Please note that with the introduction of [HTML filtering](./Static-filter-syntax#html-filters), the `script:contains(...)` syntax is now deprecated and internally converted into an equivalent `##^script:has-text(...)` HTML filter.
|
||||||
|
|
||||||
Where the value inside the parenthesis in `contains(...)` can be a plain string or a literal javascript regular expression (`/.../`). A script tag cosmetic filter will prevent the execution of whatever javascript inside a **specific** script tag when there is a match, i.e. when the plain text or the regular expression is found inside the script tag.
|
Where the value inside the parenthesis in `contains(...)` can be a plain string or a literal javascript regular expression (`/.../`). A script tag cosmetic filter will prevent the execution of whatever javascript inside a **specific** script tag when there is a match, i.e. when the plain text or the regular expression is found inside the script tag.
|
||||||
|
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
You can manually edit rules for per-site switches in the _"My rules"_ pane in the dashboard.
|
You can manually edit rules for per-site switches in the _"My rules"_ pane in the dashboard.
|
||||||
|
|
||||||
There are no temporary vs. permanent settings for the [per-site switches](https://github.com/gorhill/uBlock/wiki/Quick-guide:-popup-user-interface#the-site-based-switches), any change to one or more switches will be immediately reflected in the permanent settings.
|
There are no temporary vs. permanent settings for the [per-site switches](./Quick-guide:-popup-user-interface#the-site-based-switches), any change to one or more switches will be immediately reflected in the permanent settings.
|
||||||
|
|
||||||
There are currently three per-site switches supported:
|
There are currently three per-site switches supported:
|
||||||
|
|
||||||
|
|
|
@ -37,5 +37,5 @@ Also, if you want to look at memory figures, in addition to the above notes rega
|
||||||
***
|
***
|
||||||
|
|
||||||
- Notes: the above is especially true for Chromium-based browser. However with the [early preview of the Firefox version](https://github.com/gorhill/uBlock/issues/27#issuecomment-67308172), the memory churning referred to above seems to result in much smaller memory peak usage.
|
- Notes: the above is especially true for Chromium-based browser. However with the [early preview of the Firefox version](https://github.com/gorhill/uBlock/issues/27#issuecomment-67308172), the memory churning referred to above seems to result in much smaller memory peak usage.
|
||||||
- Related: ["Notes on memory benchmarks, selfies"](https://github.com/gorhill/uBlock/wiki/Notes-on-memory-benchmarks,-selfies)
|
- Related: ["Notes on memory benchmarks, selfies"](./Notes-on-memory-benchmarks,-selfies)
|
||||||
- Beware: ["Popup UI of extensions causes systematic memory leaks"](https://code.google.com/p/chromium/issues/detail?id=441500)
|
- Beware: ["Popup UI of extensions causes systematic memory leaks"](https://code.google.com/p/chromium/issues/detail?id=441500)
|
|
@ -9,7 +9,7 @@ Examples of sloppiness:
|
||||||
- Using memory footprint figures **before** the browser's garbage collector kicks in
|
- Using memory footprint figures **before** the browser's garbage collector kicks in
|
||||||
- Not taking measures to avoid tainting memory footprint with [Chromium bug 441500](https://code.google.com/p/chromium/issues/detail?id=441500)
|
- Not taking measures to avoid tainting memory footprint with [Chromium bug 441500](https://code.google.com/p/chromium/issues/detail?id=441500)
|
||||||
- Using memory footprint figures while option pages for one of the extension are opened
|
- Using memory footprint figures while option pages for one of the extension are opened
|
||||||
- Disregarding the [contributed memory footprint to web pages](https://github.com/gorhill/uBlock/wiki/Contributed-memory-usage:-benchmarks-over-time)
|
- Disregarding the [contributed memory footprint to web pages](./Contributed-memory-usage:-benchmarks-over-time)
|
||||||
- Comparing memory footprint after extensions have run for a significantly different amount of time
|
- Comparing memory footprint after extensions have run for a significantly different amount of time
|
||||||
- Using memory footprint figures after one of the extension has performed a one-time resource-intensive task (updating filter lists, etc.)
|
- Using memory footprint figures after one of the extension has performed a one-time resource-intensive task (updating filter lists, etc.)
|
||||||
- Not taking into account the amount of filters in both extensions
|
- Not taking into account the amount of filters in both extensions
|
|
@ -1,6 +1,6 @@
|
||||||
uBlock Origin ("uBO") is quite memory efficient compared to most other blockers. However, users will often report that this is not the case, or not as impressive as "advertised" by the official documentation.
|
uBlock Origin ("uBO") is quite memory efficient compared to most other blockers. However, users will often report that this is not the case, or not as impressive as "advertised" by the official documentation.
|
||||||
|
|
||||||
I already wrote about this [here](https://github.com/gorhill/uBlock/wiki/Myth:-uBlock-consumes-over-80MB). I will add more details here, as there is more than just garbage collection to factor in.
|
I already wrote about this [here](./Myth:-uBlock-consumes-over-80MB). I will add more details here, as there is more than just garbage collection to factor in.
|
||||||
|
|
||||||
When I run my benchmarks, the methodology used is to reproduce what I believe is the most common scenario: a user launches his/her browser with uBO already fully configured to his/her liking, without further changes to the selection of filter lists. The launch-and-forget scenario. I also benchmark this way for all other blockers.
|
When I run my benchmarks, the methodology used is to reproduce what I believe is the most common scenario: a user launches his/her browser with uBO already fully configured to his/her liking, without further changes to the selection of filter lists. The launch-and-forget scenario. I also benchmark this way for all other blockers.
|
||||||
|
|
||||||
|
@ -35,11 +35,11 @@ Benchmark details:
|
||||||
- Third-party cookies disabled
|
- Third-party cookies disabled
|
||||||
- uBO: default filter lists
|
- uBO: default filter lists
|
||||||
- ABP: _EasyList_, _EasyPrivacy_, _Malware Domains_. _"Acceptable ads"_ disabled
|
- ABP: _EasyList_, _EasyPrivacy_, _Malware Domains_. _"Acceptable ads"_ disabled
|
||||||
- Screenshots taken at least 15 minutes after [reference benchmark](https://github.com/gorhill/uBlock/wiki/Reference-benchmark) completed, and closing all web pages except the _Extensions_ page.
|
- Screenshots taken at least 15 minutes after [reference benchmark](./Reference-benchmark) completed, and closing all web pages except the _Extensions_ page.
|
||||||
|
|
||||||
### Reminder
|
### Reminder
|
||||||
|
|
||||||
Remember, what is covered above is what I call the extension's _own_ memory. The worst though is the contributed memory footprint by Adblock Plus for web pages. The sum of all [contributed memory footprint by ABP to all opened web pages](https://github.com/gorhill/uBlock/wiki/uBlock-vs.-ABP:-efficiency-compared#added-memory-footprint-to-web-pages) relative to uBlock's contributed memory footprint can easily **dwarf** the difference shown above, due to the fact that ABP will inject 14,000+ CSS rules in every web page, and every `iframe` of every web page, and this is when using _EasyList_ only.
|
Remember, what is covered above is what I call the extension's _own_ memory. The worst though is the contributed memory footprint by Adblock Plus for web pages. The sum of all [contributed memory footprint by ABP to all opened web pages](./uBlock-vs.-ABP:-efficiency-compared#added-memory-footprint-to-web-pages) relative to uBlock's contributed memory footprint can easily **dwarf** the difference shown above, due to the fact that ABP will inject 14,000+ CSS rules in every web page, and every `iframe` of every web page, and this is when using _EasyList_ only.
|
||||||
|
|
||||||
### Addendum
|
### Addendum
|
||||||
|
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
#### Overview
|
#### Overview
|
||||||
|
|
||||||
[Overview of uBlock's network filtering engine](https://github.com/gorhill/uBlock/wiki/Overview-of-uBlock's-network-filtering-engine)
|
[Overview of uBlock's network filtering engine](./Overview-of-uBlock's-network-filtering-engine)
|
||||||
|
|
||||||
#### Dynamic URL filtering rules
|
#### Dynamic URL filtering rules
|
||||||
|
|
||||||
|
@ -33,7 +33,7 @@ Advantages:
|
||||||
- Support cosmetic filtering (removal of DOM elements).
|
- Support cosmetic filtering (removal of DOM elements).
|
||||||
- Can be loaded from a filter list: facilitate community-supported filter lists.
|
- Can be loaded from a filter list: facilitate community-supported filter lists.
|
||||||
- Compatibility: can be used in other blockers supporting ABP-compatible filter syntax.
|
- Compatibility: can be used in other blockers supporting ABP-compatible filter syntax.
|
||||||
- Except for [a few filter syntax extensions specific to uBlock](https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#extended-syntax) not adopted by other blockers.
|
- Except for [a few filter syntax extensions specific to uBlock](./Static-filter-syntax#extended-syntax) not adopted by other blockers.
|
||||||
|
|
||||||
Disadvantages:
|
Disadvantages:
|
||||||
- High overhead creating/deleting network/cosmetic filters (high memory churn).
|
- High overhead creating/deleting network/cosmetic filters (high memory churn).
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
Just a place for me to keep track of comparative memory usage over time. Screenshot before/after [reference benchmark](https://github.com/gorhill/uBlock/wiki/Reference-benchmark). Great care taken to ensure memory was garbage collected before screenshots taken. To force memory garbage collection, browser left on idle for more than 1 minute, then dev console of each extension opened, _Timeline_ tab, then clicked twice on the trash can icon.
|
Just a place for me to keep track of comparative memory usage over time. Screenshot before/after [reference benchmark](./Reference-benchmark). Great care taken to ensure memory was garbage collected before screenshots taken. To force memory garbage collection, browser left on idle for more than 1 minute, then dev console of each extension opened, _Timeline_ tab, then clicked twice on the trash can icon.
|
||||||
|
|
||||||
### 23 December 2014
|
### 23 December 2014
|
||||||
|
|
||||||
|
|
|
@ -8,7 +8,7 @@ The per-site switches allows you to control uBlock's behavior on a per-site basi
|
||||||
|
|
||||||
New in [1.17.0](https://github.com/gorhill/uBlock/commit/6d34a52179aaa8fdf701b3bc7ab80f02ed5f0f23):
|
New in [1.17.0](https://github.com/gorhill/uBlock/commit/6d34a52179aaa8fdf701b3bc7ab80f02ed5f0f23):
|
||||||
|
|
||||||
Changes to the state of per-site switches will be deemed temporary **if and only if** the [overview panel](https://github.com/gorhill/uBlock/wiki/Quick-guide:-popup-user-interface#the-overview-panel) is visible.
|
Changes to the state of per-site switches will be deemed temporary **if and only if** the [overview panel](./Quick-guide:-popup-user-interface#the-overview-panel) is visible.
|
||||||
|
|
||||||
When the overview panel is not visible, toggling a per-site switch will cause the change to be permanent (i.e. same behavior as before).
|
When the overview panel is not visible, toggling a per-site switch will cause the change to be permanent (i.e. same behavior as before).
|
||||||
|
|
||||||
|
@ -45,7 +45,7 @@ The second icon is to toggle on/off the blocking of large media elements for the
|
||||||
|
|
||||||
![Popup UI](https://user-images.githubusercontent.com/585534/46021215-2573f900-c0ae-11e8-93ea-762cccfaa968.png)<br><sup>The badge shows the number of large media elements that have been blocked on the page.</sup>
|
![Popup UI](https://user-images.githubusercontent.com/585534/46021215-2573f900-c0ae-11e8-93ea-762cccfaa968.png)<br><sup>The badge shows the number of large media elements that have been blocked on the page.</sup>
|
||||||
|
|
||||||
By default, this setting is disabled. The global default can be enabled in the [_Settings_ pane](https://github.com/gorhill/uBlock/wiki/Dashboard:-Settings) in the [dashboard](https://github.com/gorhill/uBlock/wiki/Dashboard).
|
By default, this setting is disabled. The global default can be enabled in the [_Settings_ pane](./Dashboard:-Settings) in the [dashboard](./Dashboard).
|
||||||
|
|
||||||
![a](https://user-images.githubusercontent.com/585534/46021852-818b4d00-c0af-11e8-8fdb-e028bc20e8ae.png)
|
![a](https://user-images.githubusercontent.com/585534/46021852-818b4d00-c0af-11e8-8fdb-e028bc20e8ae.png)
|
||||||
|
|
||||||
|
@ -103,7 +103,7 @@ Cosmetic filtering is always enabled by default.
|
||||||
> This switch can help uBO to further lower its CPU-cycle footprint, which might be beneficial on devices with limited CPU-cycle resources -- and thus helping extend battery life and speed up page load times. The idea is to disable cosmetic filtering everywhere by default, and to enable it only for those sites which really benefit from it.
|
> This switch can help uBO to further lower its CPU-cycle footprint, which might be beneficial on devices with limited CPU-cycle resources -- and thus helping extend battery life and speed up page load times. The idea is to disable cosmetic filtering everywhere by default, and to enable it only for those sites which really benefit from it.
|
||||||
> ***
|
> ***
|
||||||
|
|
||||||
To disable cosmetic filtering everywhere by default, go to the [_Settings_ pane](https://github.com/gorhill/uBlock/wiki/Dashboard:-Settings) in the [dashboard](https://github.com/gorhill/uBlock/wiki/Dashboard), and check the option _"Disable cosmetic filtering"_ under the _"Default behavior"_ header:
|
To disable cosmetic filtering everywhere by default, go to the [_Settings_ pane](./Dashboard:-Settings) in the [dashboard](./Dashboard), and check the option _"Disable cosmetic filtering"_ under the _"Default behavior"_ header:
|
||||||
|
|
||||||
![Disable cosmetic filtering everywhere by default](https://user-images.githubusercontent.com/585534/46022246-3887c880-c0b0-11e8-9edc-ded22a011996.png)
|
![Disable cosmetic filtering everywhere by default](https://user-images.githubusercontent.com/585534/46022246-3887c880-c0b0-11e8-9edc-ded22a011996.png)
|
||||||
|
|
||||||
|
@ -117,7 +117,7 @@ You can prevent web fonts from being downloaded for the current site:
|
||||||
|
|
||||||
![Popup UI](https://user-images.githubusercontent.com/585534/46021462-b9de5b80-c0ae-11e8-82d9-f763bcd841ca.png)<br><sup>The badge shows the number of font resources that have been seen on the page.</sup>
|
![Popup UI](https://user-images.githubusercontent.com/585534/46021462-b9de5b80-c0ae-11e8-82d9-f763bcd841ca.png)<br><sup>The badge shows the number of font resources that have been seen on the page.</sup>
|
||||||
|
|
||||||
Because of security and privacy concerns, many prefer to block all web fonts by default -- toggle the appropriate default behavior in the [_Settings_ pane](https://github.com/gorhill/uBlock/wiki/Dashboard:-Settings) in the [dashboard](https://github.com/gorhill/uBlock/wiki/Dashboard):
|
Because of security and privacy concerns, many prefer to block all web fonts by default -- toggle the appropriate default behavior in the [_Settings_ pane](./Dashboard:-Settings) in the [dashboard](./Dashboard):
|
||||||
|
|
||||||
![Block remote fonts everywhere by default](https://user-images.githubusercontent.com/585534/46022554-da0f1a00-c0b0-11e8-9689-542f26b7126e.png)
|
![Block remote fonts everywhere by default](https://user-images.githubusercontent.com/585534/46022554-da0f1a00-c0b0-11e8-9689-542f26b7126e.png)
|
||||||
|
|
||||||
|
@ -150,10 +150,10 @@ This master switch has blocking precedence over dynamic filtering rules and stat
|
||||||
|
|
||||||
Furthermore, when JavaScript is disabled through this master switch, [`noscript`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/noscript#Example) tags will be honoured on a page (as opposed to when just using filters/rules to block script resources).
|
Furthermore, when JavaScript is disabled through this master switch, [`noscript`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/noscript#Example) tags will be honoured on a page (as opposed to when just using filters/rules to block script resources).
|
||||||
|
|
||||||
As with some other per-site switches, the default state of per-site JavaScript master switch can be set in the [_Settings_ pane](https://github.com/gorhill/uBlock/wiki/Dashboard:-Settings), thus allowing to disable JavaScript everywhere by default, and enable on a per-site basis:
|
As with some other per-site switches, the default state of per-site JavaScript master switch can be set in the [_Settings_ pane](./Dashboard:-Settings), thus allowing to disable JavaScript everywhere by default, and enable on a per-site basis:
|
||||||
|
|
||||||
![a](https://user-images.githubusercontent.com/585534/46022411-84d30880-c0b0-11e8-9055-7e37b113ec13.png)
|
![a](https://user-images.githubusercontent.com/585534/46022411-84d30880-c0b0-11e8-9055-7e37b113ec13.png)
|
||||||
|
|
||||||
JavaScript master switch rules appear as `no-scripting: [hostname] true` entries in the [_My rules_ pane](https://github.com/gorhill/uBlock/wiki/Dashboard:-My-rules).
|
JavaScript master switch rules appear as `no-scripting: [hostname] true` entries in the [_My rules_ pane](./Dashboard:-My-rules).
|
||||||
|
|
||||||
The JavaScript master switch can be disabled through the "Relax blocking mode" keyboard shortcut.
|
The JavaScript master switch can be disabled through the "Relax blocking mode" keyboard shortcut.
|
|
@ -3,7 +3,7 @@
|
||||||
Unlike uMatrix, uBlock can't foil cookie headers. For privacy-minded users it is strongly suggested to...
|
Unlike uMatrix, uBlock can't foil cookie headers. For privacy-minded users it is strongly suggested to...
|
||||||
|
|
||||||
- Enable _"Block third-party cookies and site data"_ in _"Content settings"_ / _"Cookies"_.
|
- Enable _"Block third-party cookies and site data"_ in _"Content settings"_ / _"Cookies"_.
|
||||||
- It works very well: see "Outbound cookies" in [this benchmark results](https://github.com/gorhill/uBlock/wiki/%C2%B5Block-and-others:-Blocking-ads,-trackers,-malwares).
|
- It works very well: see "Outbound cookies" in [this benchmark results](./%C2%B5Block-and-others:-Blocking-ads,-trackers,-malwares).
|
||||||
- But this may break some sites. For instance, you won't be able to enter comments on Youtube.
|
- But this may break some sites. For instance, you won't be able to enter comments on Youtube.
|
||||||
- Useful to know: the block also applies to local storages, not just cookies.
|
- Useful to know: the block also applies to local storages, not just cookies.
|
||||||
- Enable _"Click to play"_ in _"Content settings"_ / _"Plug-ins"_.
|
- Enable _"Click to play"_ in _"Content settings"_ / _"Plug-ins"_.
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to _"Static filter syntax"_](https://github.com/gorhill/uBlock/wiki/Static-filter-syntax)
|
[Back to _"Static filter syntax"_](./Static-filter-syntax)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
[Back to Wiki home](https://github.com/gorhill/uBlock/wiki)
|
[Back to Wiki home](./)
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -25,7 +25,7 @@ Click the large power button to turn off uBlock **for the current site** (a.k.a.
|
||||||
|
|
||||||
Alternatively, you can also <kbd>Ctrl</kbd>-click to turn off uBlock only for the current page (<kbd>command ⌘</kbd>-click on Mac).
|
Alternatively, you can also <kbd>Ctrl</kbd>-click to turn off uBlock only for the current page (<kbd>command ⌘</kbd>-click on Mac).
|
||||||
|
|
||||||
For more advanced whitelisting control, see ["How to whitelist a web site"](https://github.com/gorhill/uBlock/wiki/How-to-whitelist-a-web-site).
|
For more advanced whitelisting control, see ["How to whitelist a web site"](./How-to-whitelist-a-web-site).
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -35,15 +35,15 @@ For more advanced whitelisting control, see ["How to whitelist a web site"](http
|
||||||
|
|
||||||
#### Zap an element on the current page
|
#### Zap an element on the current page
|
||||||
|
|
||||||
Click the _flash_ icon to enter [element zapper mode](https://github.com/gorhill/uBlock/wiki/Element-zapper), which allows you to interactively remove one or more elements on the current page. Removing an element is always temporary, i.e. the removed elements will be back when the page is reloaded.
|
Click the _flash_ icon to enter [element zapper mode](./Element-zapper), which allows you to interactively remove one or more elements on the current page. Removing an element is always temporary, i.e. the removed elements will be back when the page is reloaded.
|
||||||
|
|
||||||
#### Create a filter for the current site
|
#### Create a filter for the current site
|
||||||
|
|
||||||
Click the _eye-dropper_ icon to enter [element picker mode](https://github.com/gorhill/uBlock/wiki/Element-picker), which allows you to create a filter by interactively picking an element on a page, thus permanently removing it from the page.
|
Click the _eye-dropper_ icon to enter [element picker mode](./Element-picker), which allows you to create a filter by interactively picking an element on a page, thus permanently removing it from the page.
|
||||||
|
|
||||||
#### Open the logger
|
#### Open the logger
|
||||||
|
|
||||||
Click the _list_ icon to open the [logger](https://github.com/gorhill/uBlock/wiki/The-logger) in a separate tab. This allows you to inspect real-time network traffic within the browser.
|
Click the _list_ icon to open the [logger](./The-logger) in a separate tab. This allows you to inspect real-time network traffic within the browser.
|
||||||
|
|
||||||
Tip: press the <kbd>Shift</kbd> key while clicking the icon to toggle between opening the logger in a separate window or separate tab. uBO will remember that setting when you open the logger without the <kbd>Shift</kbd> key.
|
Tip: press the <kbd>Shift</kbd> key while clicking the icon to toggle between opening the logger in a separate window or separate tab. uBO will remember that setting when you open the logger without the <kbd>Shift</kbd> key.
|
||||||
|
|
||||||
|
@ -79,7 +79,7 @@ There is a good correlation between the _domains connected_ count and: unneeded
|
||||||
|
|
||||||
Example: the web page on <http://www.ibtimes.com/> (which can be read fine in all cases, by the way):
|
Example: the web page on <http://www.ibtimes.com/> (which can be read fine in all cases, by the way):
|
||||||
|
|
||||||
uBlock's mode | turned off | default settings | [default-deny](https://github.com/gorhill/uBlock/wiki/Blocking-mode:-medium-mode)
|
uBlock's mode | turned off | default settings | [default-deny](./Blocking-mode:-medium-mode)
|
||||||
--- | --- | --- | ---
|
--- | --- | --- | ---
|
||||||
domains connected | ![](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/popup-1e.png) | ![](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/popup-1d.png) | ![](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/popup-1f.png)
|
domains connected | ![](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/popup-1e.png) | ![](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/popup-1d.png) | ![](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/popup-1f.png)
|
||||||
privacy exposure | very high | medium | very low
|
privacy exposure | very high | medium | very low
|
||||||
|
@ -104,7 +104,7 @@ To hide that panel, just click again on either the _"requests blocked"_ or _"dom
|
||||||
|
|
||||||
Unless you are in "advanced user" mode, this panel is read-only and available only for informational purpose.
|
Unless you are in "advanced user" mode, this panel is read-only and available only for informational purpose.
|
||||||
|
|
||||||
In ["advanced user"](https://github.com/gorhill/uBlock/wiki/Advanced-user-features) mode, the panel is fully interactive and can be used for advanced filtering control.
|
In ["advanced user"](./Advanced-user-features) mode, the panel is fully interactive and can be used for advanced filtering control.
|
||||||
|
|
||||||
<sub>__*__ The panel will also be expanded when you enable "advanced user" mode -- this is only for convenience -- it will not close automatically when "advanced user" will be disabled.</sub>
|
<sub>__*__ The panel will also be expanded when you enable "advanced user" mode -- this is only for convenience -- it will not close automatically when "advanced user" will be disabled.</sub>
|
||||||
|
|
||||||
|
@ -114,4 +114,4 @@ In ["advanced user"](https://github.com/gorhill/uBlock/wiki/Advanced-user-featur
|
||||||
|
|
||||||
![Popup UI](https://user-images.githubusercontent.com/585534/46020955-8bac4c00-c0ad-11e8-8c33-33fc921cfcc6.png)
|
![Popup UI](https://user-images.githubusercontent.com/585534/46020955-8bac4c00-c0ad-11e8-8c33-33fc921cfcc6.png)
|
||||||
|
|
||||||
The per-site switches allow you to control some settings on a per-site basis. See [detailed documentation about per-site switches](https://github.com/gorhill/uBlock/wiki/Per-site-switches).
|
The per-site switches allow you to control some settings on a per-site basis. See [detailed documentation about per-site switches](./Per-site-switches).
|
||||||
|
|
|
@ -267,7 +267,7 @@ Parameters:
|
||||||
***
|
***
|
||||||
|
|
||||||
### overlay-buster.js [↪](https://github.com/gorhill/uBlock/blob/a94df7f3b27080ae2dcb3b914ace39c0c294d2f6/assets/resources/scriptlets.js#L633)
|
### overlay-buster.js [↪](https://github.com/gorhill/uBlock/blob/a94df7f3b27080ae2dcb3b914ace39c0c294d2f6/assets/resources/scriptlets.js#L633)
|
||||||
Experimental, gets rid of overlay dialogs, works for ~30s after page load. Preferred way to handle overlays is to use standard cosmetic filters and optionally [style injection](https://github.com/gorhill/uBlock/wiki/Static-filter-syntax#style).
|
Experimental, gets rid of overlay dialogs, works for ~30s after page load. Preferred way to handle overlays is to use standard cosmetic filters and optionally [style injection](./Static-filter-syntax#style).
|
||||||
|
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
|
@ -4,4 +4,4 @@ There is so much of these... I will collect then here in the hope this will be u
|
||||||
|
|
||||||
> it would be blocking ads and cookies, so the longer you watch, the more ads and cookies there are
|
> it would be blocking ads and cookies, so the longer you watch, the more ads and cookies there are
|
||||||
|
|
||||||
The real answer: the count in the uBlock Origin icon is the number of **blocked network requests** since the page was last fully loaded. These blocked network requests can be that of "ads" or anything else which is worth blocking as per selected filter lists. For details about the blocked network requests, use the [logger](https://github.com/gorhill/uBlock/wiki/The-logger). uBlock Origin does not block cookies directly, it blocks network requests. If a blocked network request has a `Set-Cookie` header, the cookie payload will be blocked indirectly as a consequence of blocking the network request.
|
The real answer: the count in the uBlock Origin icon is the number of **blocked network requests** since the page was last fully loaded. These blocked network requests can be that of "ads" or anything else which is worth blocking as per selected filter lists. For details about the blocked network requests, use the [logger](./The-logger). uBlock Origin does not block cookies directly, it blocks network requests. If a blocked network request has a `Set-Cookie` header, the cookie payload will be blocked indirectly as a consequence of blocking the network request.
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
I am going to collect here common usage issues users may face.
|
I am going to collect here common usage issues users may face.
|
||||||
|
|
||||||
The best way to troubleshoot uBlock is with uBlock: the [logger](https://github.com/gorhill/uBlock/wiki/The-logger) will tell you what uBlock is doing when you try to load a web page. Using the logger is the first thing you should try when you are trying to find out why a page does not load/display as expected.
|
The best way to troubleshoot uBlock is with uBlock: the [logger](./The-logger) will tell you what uBlock is doing when you try to load a web page. Using the logger is the first thing you should try when you are trying to find out why a page does not load/display as expected.
|
||||||
|
|
||||||
***
|
***
|
||||||
|
|
||||||
|
@ -69,7 +69,7 @@ Specifically, it has been confirmed [Avira Anti-virus has been uninstalling uBlo
|
||||||
|
|
||||||
#### Unable to open links in new tab
|
#### Unable to open links in new tab
|
||||||
|
|
||||||
- Are you using the [no-popups switch](https://github.com/gorhill/uBlock/wiki/Quick-guide:-popup-user-interface#no-popups)?
|
- Are you using the [no-popups switch](./Quick-guide:-popup-user-interface#no-popups)?
|
||||||
- Are you using a Chromium-based browser?
|
- Are you using a Chromium-based browser?
|
||||||
|
|
||||||
If you answer "yes" to both questions above, this is your problem (from link above):
|
If you answer "yes" to both questions above, this is your problem (from link above):
|
||||||
|
|
|
@ -17,7 +17,7 @@ uBlock and Disconnect required no extra configuration steps. Other blockers requ
|
||||||
Caveat: "3rd-party" is defined as a domain which doesn't match the domain of the web page. For sure many
|
Caveat: "3rd-party" is defined as a domain which doesn't match the domain of the web page. For sure many
|
||||||
domains reported as "3rd-party" actually belong to the same entity which owns the page domain (for example, `yimg.com` is owned by `yahoo.com`). There is no way for the benchmark code to know this, unless using a comprehensive database of who owns which domain -- that is beyond my means. Still, the benchmark is useful if comparing blockers among themselves, or against when no blocker is used.
|
domains reported as "3rd-party" actually belong to the same entity which owns the page domain (for example, `yimg.com` is owned by `yahoo.com`). There is no way for the benchmark code to know this, unless using a comprehensive database of who owns which domain -- that is beyond my means. Still, the benchmark is useful if comparing blockers among themselves, or against when no blocker is used.
|
||||||
|
|
||||||
The URLs (84) from the [reference benchmark](https://github.com/gorhill/uBlock/wiki/Reference-benchmark) were used.
|
The URLs (84) from the [reference benchmark](./Reference-benchmark) were used.
|
||||||
|
|
||||||
Results -- figures are "3rd party / all". Ordered from least 3rd-party hits to most 3rd-party hits. Privacy-wise, lower numbers are better.
|
Results -- figures are "3rd party / all". Ordered from least 3rd-party hits to most 3rd-party hits. Privacy-wise, lower numbers are better.
|
||||||
|
|
||||||
|
@ -84,7 +84,7 @@ Using the data diffs, one can observe that with uBlock + default settings, there
|
||||||
- `twitter.com` (34)
|
- `twitter.com` (34)
|
||||||
- `taboola.com` (11)
|
- `taboola.com` (11)
|
||||||
|
|
||||||
So if this concerns you (it should), I would say the best way to foil these is to use [dynamic filtering](https://github.com/gorhill/uBlock/wiki/Dynamic-filtering). Here are the rules, which will block all these 3rd-parties, except when used as 1st-party:
|
So if this concerns you (it should), I would say the best way to foil these is to use [dynamic filtering](./Dynamic-filtering). Here are the rules, which will block all these 3rd-parties, except when used as 1st-party:
|
||||||
|
|
||||||
* facebook.com * block
|
* facebook.com * block
|
||||||
* facebook.net * block
|
* facebook.net * block
|
||||||
|
|
|
@ -11,7 +11,7 @@ Here is a quick illustrated comparison of efficiency using various angles. Each
|
||||||
|
|
||||||
### Own memory footprint
|
### Own memory footprint
|
||||||
|
|
||||||
These screenshots show the memory footprint of ABP and uBlock _after_ they have gone through this rather [demanding benchmark](https://github.com/gorhill/uBlock/wiki/Reference-benchmark). Once the benchmark was completed, I forced the browser to garbage collect the memory in each extension by clicking the trash icon (in dev console) a couple of times -- this is an _important step_, or else the shown memory footprint is not too reliable.
|
These screenshots show the memory footprint of ABP and uBlock _after_ they have gone through this rather [demanding benchmark](./Reference-benchmark). Once the benchmark was completed, I forced the browser to garbage collect the memory in each extension by clicking the trash icon (in dev console) a couple of times -- this is an _important step_, or else the shown memory footprint is not too reliable.
|
||||||
|
|
||||||
##### Adblock Plus
|
##### Adblock Plus
|
||||||
![ABP](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/abp-own-mem.png)
|
![ABP](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/abp-own-mem.png)
|
||||||
|
@ -27,7 +27,7 @@ Both extensions had _EasyList_, _EasyPrivacy_, _Peter Lowe's Ad Server_ list, an
|
||||||
|
|
||||||
ABP and uBlock need to evaluate the URL of each net request against their dictionary of filters, and eventually tell the waiting browser whether the request should be cancelled or not. Since the browser is waiting for an answer, this is a time critical part and determining whether the request should be allowed or not must be done as fast as possible.
|
ABP and uBlock need to evaluate the URL of each net request against their dictionary of filters, and eventually tell the waiting browser whether the request should be cancelled or not. Since the browser is waiting for an answer, this is a time critical part and determining whether the request should be allowed or not must be done as fast as possible.
|
||||||
|
|
||||||
Below are the average time it takes for each extension to handle a net request in their respective `chrome.webRequest.onBeforeRequest` handler, using the same [benchmark](https://github.com/gorhill/uBlock/wiki/Reference-benchmark).
|
Below are the average time it takes for each extension to handle a net request in their respective `chrome.webRequest.onBeforeRequest` handler, using the same [benchmark](./Reference-benchmark).
|
||||||
|
|
||||||
##### Adblock Plus 1.8.10
|
##### Adblock Plus 1.8.10
|
||||||
|
|
||||||
|
@ -57,7 +57,7 @@ Below are the average time it takes for each extension to handle a net request i
|
||||||
|
|
||||||
##### Methodology
|
##### Methodology
|
||||||
|
|
||||||
Note that the results above are the tail end of running the [reference benchmark](https://github.com/gorhill/uBlock/wiki/Reference-benchmark), except `wait` set to 15, and `repeat` set to 1. Both ABP and uBlock set to use _EasyList_, _EasyPrivacy_, _"Peter Lowe’s Ad server list"_, _"Malware domains"_. ABP-specific: _"Acceptable ads"_ disabled. µBlock-specific: default settings.
|
Note that the results above are the tail end of running the [reference benchmark](./Reference-benchmark), except `wait` set to 15, and `repeat` set to 1. Both ABP and uBlock set to use _EasyList_, _EasyPrivacy_, _"Peter Lowe’s Ad server list"_, _"Malware domains"_. ABP-specific: _"Acceptable ads"_ disabled. µBlock-specific: default settings.
|
||||||
|
|
||||||
The results depend heavily on the processor: I benchmarked on an i5-3xxxK CPU @ 3.4 GHz x 4.
|
The results depend heavily on the processor: I benchmarked on an i5-3xxxK CPU @ 3.4 GHz x 4.
|
||||||
|
|
||||||
|
@ -105,6 +105,6 @@ Also, the amount of work µBlock does in its content scripts is proportional to
|
||||||
|
|
||||||
### Related wiki pages
|
### Related wiki pages
|
||||||
|
|
||||||
- [Counterarguments: Who cares about efficiency, I have 8 GB](https://github.com/gorhill/uBlock/wiki/Counterarguments#who-care-about-efficiency-i-have-8-gb)
|
- [Counterarguments: Who cares about efficiency, I have 8 GB](./Counterarguments#who-care-about-efficiency-i-have-8-gb)
|
||||||
- [Net request filtering efficiency: HTTP Switchboard vs. Adblock Plus](https://github.com/gorhill/httpswitchboard/wiki/Net-request-filtering-efficiency:-HTTP-Switchboard-vs.-Adblock-Plus)
|
- [Net request filtering efficiency: HTTP Switchboard vs. Adblock Plus](https://github.com/gorhill/httpswitchboard/wiki/Net-request-filtering-efficiency:-HTTP-Switchboard-vs.-Adblock-Plus)
|
||||||
- [Adblock Plus memory consumption](https://github.com/gorhill/httpswitchboard/wiki/Adblock-Plus-memory-consumption)
|
- [Adblock Plus memory consumption](https://github.com/gorhill/httpswitchboard/wiki/Adblock-Plus-memory-consumption)
|
|
@ -18,7 +18,7 @@ This is the "novice user" interface, which is the default when installing for th
|
||||||
- The network request logger (the _eye_ icon) is now always available
|
- The network request logger (the _eye_ icon) is now always available
|
||||||
- There is no more setting to enable/disable the network request logger, it will be turned on/off automatically when opening/closing the logger page
|
- There is no more setting to enable/disable the network request logger, it will be turned on/off automatically when opening/closing the logger page
|
||||||
|
|
||||||
To access dynamic filtering, you need to indicate to µBlock that you are an advanced user (mind the ["Required reading"](https://github.com/gorhill/uBlock/wiki/Advanced-user-features) link):
|
To access dynamic filtering, you need to indicate to µBlock that you are an advanced user (mind the ["Required reading"](./Advanced-user-features) link):
|
||||||
|
|
||||||
![figure 2](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/df-tut-02.png)
|
![figure 2](https://raw.githubusercontent.com/gorhill/uBlock/master/doc/img/df-tut-02.png)
|
||||||
|
|
||||||
|
@ -69,4 +69,4 @@ An example (below): globally block network requests to ubiquitous `googletagserv
|
||||||
|
|
||||||
So the dynamic filtering rule above says: block network requests to `googletagservices.com` from anywhere.
|
So the dynamic filtering rule above says: block network requests to `googletagservices.com` from anywhere.
|
||||||
|
|
||||||
Side note: `googletagservices.com` is not blocked by _EasyPrivacy_, but it is blocked by Ghostery, this is one of the reason it fared better in [privacy exposure benchmarks](https://github.com/gorhill/uBlock/wiki/%C2%B5Block-and-others:-Blocking-ads,-trackers,-malwares).
|
Side note: `googletagservices.com` is not blocked by _EasyPrivacy_, but it is blocked by Ghostery, this is one of the reason it fared better in [privacy exposure benchmarks](./%C2%B5Block-and-others:-Blocking-ads,-trackers,-malwares).
|
||||||
|
|
Loading…
Reference in New Issue