See release notes.

New:

Static filter option elemhide as per ABP semantic

The elemhide option is now fully supported, rather than being an alias of generichide. The elemhide option will be internally converted into two filters, generichide and specifichide. There have been cases raised by filter list maintainers where specifichide would be useful. Additionally, the filter options elemhide, generichide and specifichide can be aliased with ehide, ghide and shide respectively. (generichide appears over 1,300 times just in "uBlock filters".)

Closed as fixed:

• Prevent uBO from being reloaded mid-session
  
  • A new advanced setting -- extensionUpdateForceReload -- can be used to override this new behavior.
• Comply with new security requirements for Chrome
  
  • The changes benefit all platforms.
• Add advanced setting to control logger popup type
• Ignoring ping filters

Commits with no entry in issue tracker:

• Fix bad returned value in case of empty URL
• Avoid or defer writing back to cache storage at launch
• Do not bypass network listener in suspended mode
• Remove stats button from logger
• Log procedural cosmetic exception filters
• Prevent reverse-lookup from finding badfilter-ed filters
• Reduce memory usage in staticExtFilteringEngine.HostnameBasedDB
• Store csp= filters into main data structure
• Add ability to quickly create exceptions in logger
• Match static popup filter against local context
• Fix erroneous reports of blocked popups in logger
• Fix case of unreported :style filters in logger
• Do not flush blocked-elements cache at webNavigation time
• Remove remnants of chrome references
• Add support for elemhide (through specifichide)
• Simplify client messaging code
• Removing now obsolete Safari code base
• Revisit element picker arguments code
• Convert new setTimeout-if scriptlet to blacklist approach
• Work toward modernizing code base: promisification
• Fix icon title always showing (0) when badge is disabled
• Reuse existing Set/Map when calling scriptletFilteringEngine.retrieve
• Fix entity-based lookup in html & scriptlet filtering
• Coalesce tab reloads in burst "relax blocking mode" ops

Commits history since 1.22.4.

See release notes.

This is an emergency fix.

The issue was fixed in dev build days ago, and it was originally deemed to not be a serious regression.

However as reported by a user on Reddit, the issue was affecting more than just the logging of cosmetic filters, it was completely breaking cosmetic filtering when the two following conditions were met:

• uBO's own logger was opened; AND
• Procedural cosmetic filters were injected on the page.

Commits history since 1.22.2.

See release notes.

Emergency fix in ac7825c789ce: redirection rules could be
ignored under some circumstances. Regression from 3e5c9e00ab36.

Commits history since 1.22.0.

See release notes.

New

Toolbar icon badge color

The toolbar icon badge color will now reflect the current blocking mode. This should help with usage of the "Relax blocking mode" shortcut. The way uBO relaxes the current blocking mode is configurable through the advanced setting blockingProfiles.

Static network filter options

redirect-rule=

This new option allows to create a pure redirect directive, without a corresponding block filter as would be the case with the redirect= option. For example, consider the following filter:

||example.com/ads.js$script,redirect=noop.js

The above filter will result in a block filter ||example.com/ads.js$script and a matching redirect directive. Now consider this following filter:

||example.com/ads.js$script,redirect-rule=noop.js

The above filter will not cause a block filter to be created, only a redirect directive will be created. Standalone redirect directives are useful when the blocking of a resource is optional but we still want the resource to be redirected should it ever be blocked by whatever mean -- whether through a separate block filter, a dynamic filtering rule, etc.

empty and mp4

Support for AdGuard's empty and mp4 filter option has been added.

!#if false ... !#endif

Support for the directive !#if false to easily disable a block of filters, which is more convenient than having to delete them all or prefix them all with !.

Scriptlet injection

Ability to wholly disable scriptlet injection for a given site using broad scriptlet injection exception:

example.com#@#+js()

It is also possible to disable scriptlet injection everywhere with a generic exception:

#@#+js()

This is useful when creating specific exception filters is inconvenient.

Closed as fixed:

• Support AdGuard's empty & mp4 static filter options
• Add ability to bypass browser cache when fetching a resource
• Extension icon doesn't revert back when the domain is removed from Whitelist tab
• Dead code in assets.js
• Popup panel closing when forcing a reload
• uBlock does not appear to honor overriding default assets.json via Chrome policy
• uBo logger show not used :style(...) filters
• Block Element doesn't appear in the context menu of a tab under specific circumstances
• Cosmetic filters containing pseudo-elements do not show results in manual/interactive selection mode

Commits with no entry in issue tracker:

• Add support for !#if false in list directive processor
• Code review fix re. max string length in bidi-trie
• Add two scriptlets: setTimeout-if and setInterval-if
• Fix badly computed output size in µBlock.base64.encode()
• Add new scriptlet to defuse calls to requestAnimationFrame
• Add support for special exception filter #@#+js()
• Add ability to escape comma in a scriptlet's list of arguments
• Review icon badge color management
• Reflect blocking mode in badge color of toolbar icon
• Invalidate browser's memory cache after using element picker
• Add virtuous signal that remote code execution in extension context is not possible

Commits history since 1.21.2

See release notes.

New:

New procedural cosmetic/HTML filtering operator: min-text-length(x), where x is the minimal text length of the subject DOM element. It is chainable. Example:

example.de##^script:has-text(.charCodeAt):min-text-length(14000)


New keyboard shortcut available: "Relax blocking mode". Use it to lower the current blocking mode to a lower one. Currently the default behavior is:

1) Allow JavaScript; or
2) Allow 3rd-party network requests

Consequently, if your default blocking profile is to disable JavaScript and 3rd-party network requests, you will need to press twice to lower uBO's blocking mode to the lowest blocking mode achievable through the keyboard command. The current web page will be automatically reloaded each time the current blocking mode is lowered.

The shortcut will have no effect when the current blocking mode in effect does not forbid JavaScript and 3rd-party requests.

Closed as fixed:

• url(...) style injections in cosmetic filters
• Parse search string as plaintext to avoid doubling \
• Commit button gets stuck under specific circumstances
• Whitelisting behind-the-scene causes uBO to disregard the moz-extension-scheme rule
• Add link to open urls in a new tab
• Thunderbird's 1.20.0 xpi contains version 1.9.15.101
• Coalesce common plain filters in a bucket into a single trie
• Temporary dynamic filters with 3p-script won't save
• Keyboard shortcut to change modes

Commits with no entry in issue tracker:

• Fix thrown exception in onHeadersReceived listener
• Prevent adding known invalid URL-based rules
• Fix background color of previewed image in logger
• Finalize converting resources.txt into immutable resources
• Save only modified immediate hidden settings
• Refactor management of injectable resources
• Strict-block only if match is anchored to end of hostname
• Minor code review re. context menu code
• Add ability to suspend network request handler at will
• Fix some element picker-related issues
• Fix merging multiple URls in element picker
• Replace exec with transpose in procedural filters
• Add test pages for procedural filters
• Add new procedural operator: :min-text-length(x)

Commits history since 1.20.2

See release notes.

No changes from 1.20.0.

This release exists only to fulfill a request by Mozilla that I submit a new version even if there is no code change, so as to test changes on the back-end of AMO.

Commits history since 1.20.0

See release notes.

Closed as fixed

• Does not block large media fetched over Fetch API
• Last permanent rule is marked as changed when rules are added to the bottom
• Dashboard open from uBO popup triggers unsaved changes dialog
• Multiple "Advanced settings" opened
• Redirection fails for filters having * in the host part
• Show requests blocked in the logger as a result of csp= option
• Element picker normalize style attrib
• "#@#+js" entries are shown in the logger as yellow instead of green
• no-scripting: behind-the-scene false sticks even after restoring uBO from a config where it's not present
• Revert button remains active/clickable after clicking on Apply changes
• "Block element" item should have ellipsis (usability)
• Nested !#if/!#endif directives not evaluated properly
• Hide predefined whitelist directives
• Non-specific procedural filters
• HTML filter showing up as cosmetic filter in logger
• No warning for unsaved changes in dashboard
• Logger: can't bring up filtering options for popup entries where URL does not start with http[s]
• Switching configuration tabs [appears to stop] list updates
• Cosmetic filter exceptions not displayed in network request logger

Commits with no entry in issue tracker

• Fix generichide not being evaluated for local context
• Discard whole filter with bad csp= content
• Add a link to the remote asset in asset viewer
• Rearrange inner loop of static network filtering engine
• Fix "Close this window" not working on document-blocked page
• Add support for all filter option
• Set default delay for creating selfie to 3 minutes
• Avoid duplicated strings in filterOrigin w/ new approach
• Revisit code to benefit from ES6 syntax
• Refactor runtime storage of specific cosmetic filters
• Add support for nth-ancestor operator in HTML filtering
• Ensure "Ignore generic cosmetic filters" sticks on Fennec

Commits history since 1.20.0

See release notes.

Fixed

• Fix regression affecting `*$csp=`-like filters

Commits history since 1.19.4.

See release notes.

Fixed

• Fix error when loading a non-cached non-local asset

Commits history since 1.19.2.

See release notes.

Closed as fixed

• Untokenizable filters with one wilcard no longer work

Commits history since 1.19.0.

See release notes.

New

New cosmetic procedural operator: :nth-ancestor(x), where x is the distance from the currently selected node. It is effectively a low-overhead equivalent to :xpath(..[/..]*). Example:

##.detLink:has-text(VPN):xpath(../../..)

Could be rewritten with the new operator:

##.detLink:has-text(VPN):nth-ancestor(3)

The new operator has a lower overhead as it avoids the need to create and execute XPath expressions.

Closed as fixed

• Firefox does not load homepage completely when operating in Single-process
• No Large Media setting with 0KB should block all images
• Incorrect display of hostnames with numbers in the logger
• Remove duplicate lines when importing user filters
• Can't add some network filters via element picker, create button grayed out
• Wrong Map method used (pull request by n-leigh)
• Make the lists activate by default in browser languages that are minority languages in the lists' countries
• Dashboard tabs are unresponsive after a while
• ::before / ::after no longer hidden as generic filter?
• Using multiple userResourcesLocation lists
• userResourcesLocation URL appears twice in the logger

Commits with no entry in issue tracker

• Add HNTrieRef.dump() and STrieRef.dump() as dev tool
• Add new cosmetic procedural operator: :nth-ancestor(n)
• Do not store impossible to match filters in HNTrie
• Make token hashes fit within a 32-bit integer
• Increase resolution of known-token lookup table
• Ignore unknown tokens in urlTokenizer.getTokens()
• Fix page count computation in publicSuffixList.enableWASM()
• Convert HNTrie code to ES6 class
• Cache and reuse result of HNTrieRef.matches() when possible
• Introduce three more specialized filter classes to avoid regexes
• Use a sequence of base 64 numbers to encode array buffers
• Add HNTrie-based filter classes to store origin-only filters
• Performance + code maintenance work on static network filtering engine
• Improve usefulness of FilterContainer.benchmark()

Commits history since 1.18.16.

See release notes.

This is an emergency fix for https://github.com/NanoAdblocker/NanoCore/issues/257. The issue is that whenever an empty hostname was passed to getPublicSuffix.getDomain(), the next call to getPublicSuffix.getDomain() with a valid hostname would return an invalid result. I expect the erroneous behavior to be a rare occurrence, vast majority of calls to getPublicSuffix.getDomain() are with a valid hostname.

Side effects could be that uBO was unable to properly lookup specific cosmetic filters for a site.


Closed as fixed:

• Cosmetic filtering is not working reliably

Pull requests

• Add Norwegian Nynorsk to the nordiske filtre list

Commits history since 1.18.14.

See release notes.


Commits with no entry in issue tracker

• Fixes an issue with restoring settings from a backup file

Commits history since 1.18.12.

See release notes.


Changes

The unlimitedStorage permission has been added in Firefox, to bring uBO inline with the Chromium version. As a result, when uBO updates, Firefox will notify you about the new permission.

Note that the Chromium version of uBO has declared the unlimitedStorage permission since it was first published in 2014.

Firefox is not yet enforcing this permission, but I decided to add it anyways since Firefox states:

Only ask for "unlimitedStorage" permission if you expect your extension's local data storage to exceed 5MB if it's not going to exceed that amount, don't ask for it.

uBO is already using more than 5MB of storage in its basic configuration. uBO's cache storage is used to store filter lists, their compiled counterparts, and snapshots of various internal data structures for fast launch time).


Closed as fixed:

• "Prevent WebRTC leaking" not working as intended

Commits with no entry in issue tracker

• Simplify code to gather storage used with StorageManager.estimate()
• Code review of IndexedDB usage for cache storage purpose
• Add unlimitedStorage to Firefox manifest; add timeout to IndexedDB access
• Fix typo which could lead to improper filtering context
• uBlock Origin conflicts with Alexa Tool

Commits history since 1.18.6.

See release notes.


New

Firefox will fall back to use WebExtensions storage for cache purpose when it can't use its indexedDB storage -- for example when Firefox's history setting is set to "Never remember history".


Closed as fixed:

• uBlock appears to be unable to update filters in Firefox's private mode
• :spath(...) in uBO logger?
• Tilde added in attribs glitch/freeze Preview mode element picker when I use in Procedural cosmetic filters operator
• $inline-script,domain tests for top-level domain, not the inline-script document's
• CSS filters with unclosed pseudo classes works in preview mode

Commits with no entry in issue tracker

• Remove obsolete code related to assets storage refactoring in 1.11.0
• Fix parsing of AdGuard's #$?#-based cosmetic filters
• Remove obsolete code to translate |blob: filters into CSP filters
• Leverage whotracks.me's huge dataset of URLs for benchmark purpose
• Refactor selfie generation into a more flexible persistence mechanism
• Update publicSuffixLibrary to latest (WASM-able) version

Commits history since 1.18.4.

See release notes.

Closed as fixed:

• Cosmetic filtering not enforced at uBO launch on already opened web pages
• Compute URL of sublists as relative to URL of parent list
• Fix partyness evaluation for cases of base domain-less hostnames
• Fix Promise chain of WASM module load operations

Commits history since 1.18.2.

See release notes.


Fixed

• Improve nowebrtc.js scriptlet

Commits history since 1.18.0.

See release notes.

New

Refactoring of the logger code for performance/efficiency purpose -- the logger output has been decoupled from the DOM.

Additionally, these features were added to the logger:

• configuration settings
  
  • multiple criteria can be used for when to discard logger entries
    
  • ability to hide some columns
    
• export-to-clipboard
• the position and size of the logger-as-a-popup window will be remembered
• a pause button to stop the logger from taking in new events
• a new built-in expressions picker to filter the logger output
• show the hostname of the document which caused the resource to be fetched
• show the 3rd-partyness of a resource relative to both the page and the document fetching the resource
• new visual hint to denote tab-less network requests
• a popup panel button linked to the tab selector

Documentation will be updated eventually to account for those changes.


Closed as fixed

• Does not block JavaScript in embedded YouTube video on specific webpage
• Move early blocking of requests out of experimental status on Firefox
  
  • Made easy by Firefox's webext API, as early blocking is natively supported.
    
• Prevent sites from disabling mouse events for element picker
• Add an option to remove the URL comments in My filters (originally declined in https://github.com/gorhill/uBlock/issues/93)
• Layout problem in the strict blocking warning page on Firefox for Android
• uBO does not unhide nodes no longer matching procedural cosmetic filters
• Static extended filtering: fix empty hostnames not being detected/handled
• Cosmetic filter "##" or "##tag," same as "##*" in element picker only
• !#include directive should insert sub-content at directive point
• 3rd-gen HNTrie
• Duplicate specific cosmetic filters not discarded when "Ignore generic" is enabled
• $generichide is still applied even when website is whitelisted
• Change "IDN: ABPindo" to "IDN, MYS: ABPindo"
• Changing the button for the NOR list
• Filter list view - ugly/messy line breaking/wrapping at minus sign char
• Add X to close overlay box
• No scripting switch number not fully displayed
• Remember and reuse last position/size of the logger popup window
• Logger filter lookup overlay should scroll when filter too long
• Element picker not taking into account srcset when blocking an image = non-working network filter
• Internationalize CodeMirror's hard-coded tooltips in the "My rules" pane
• Remember the cursor position in 'My Filters' tab
• Deprecate pseudo operator :if(...), :if-not(...), reuse :has(...), :not(...)
• Improve representation of behind-the-scene network requests in the logger
• The element picker window is almost invisible
• Duplicated entry when creating dynamic filter in logger
• Logger loads blocked content in preview
• Apply stricter rejection of usage of url() in :style rules
• Normalize Adguard's plain cosmetic filters disguised as style-based filters
• Change DOM surveyor to time-based processing logic (from chunk-based)
• Improve creation of rows in dynamic filtering pane of popup panel
• Avoid redundant DOM attributes in dynamic filtering pane
• Code review related to performance in main content script

Commits history since 1.17.4.

See release notes.


Notes

I will keep bringing in WebAssembly ("wasm") versions of key portions of code where it is found to be beneficial. In this release, a wasm version of the algorithm used to lookup a hostname from a set of hostnames has been created.


Closed as fixed

• When pasting multiple lines into the rules editor they are joined together in a single line
• ##.ad.super from EasyList is causing ##.ad to not be applied
• Fix missing trailing asterisk in filter representation in the logger
• No context menu entry for data:* iframes (banners)
• UI Search field and it's search counter interfere with each other / unreadable
• "Update now" button flashes for 1 second before changing the count numbers
• Improve usability of temporarily disabling strict-blocking
• HTML filter exception doesn't work
• $badfilter does not work on a CSP filter

Commits history since 1.17.2.

No change since 1.17.0: this release is for the benefit of Firefox users, who will be able to take advantage of an up to date resources.txt asset. This new version is published on AMO only.

Commit history since 1.17.0.

See release notes.


New


Per-site JavaScript master switch

A new per-site switch has been added to the popup panel, which acts as a master switch for JavaScript for the current site.

This master switch has precedence over dynamic filtering rules and static filters related to script resources.

Furthermore, when JavaScript is disabled through this master switch, noscript 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, thus allowing to disable JavaScript everywhere by default, and enable on a per-site basis.

JavaScript master switch rules appear as no-scripting: [hostname] true entries in the My rules pane.


Temporarily toggle per-site switches

From now on, changes to the state of per-site switches will be deemed temporary if and only if the overview panel is visible, regardless of whether "advanced user" mode is enabled.

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).

However, when the overview panel is visible, toggling a per-site switch will cause the change to be temporary. In such case, there will be an eraser and a padlock icon in the overview pane, which can be used to revert or persist the current state of all the per-site switches.


Cache storage compression

A new advanced setting: cacheStorageCompression, default to true. When true, uBO will lz4-compress data before storing it in its cache storage in supported platforms. Currently, the only supported platform is Firefox/Firefox for Android.

The cache storage is used for storing downloaded filter lists, compiled filter lists, selfies. See https://github.com/uBlockOrigin/uBlock-issues/issues/141 for related discussion.


Closed as fixed


Firefox

• Error loading from the disk cache pages obtained by blocking remote fonts
• "Storage used" in settings tab says "? bytes"
  
  • It's really a workaround, consider the reported figure to be an on-the-low-side estimate
    
• Element picker mode in Firefox CSS failure on denuvo.com

Firefox for Android

• Cannot open Logger. Element picker/zapper does not switch tabs.

Core

• Use +js name for logging
• No reverse-lookup for logged HTML filter
• EasyList Thailand added to stock filter lists
• Various spelling fixes
• “manualUpdateAssetFetchPeriod” setting doesn't save the changes
• False positive detection of popups is broken
• "uBlock — Assets" should be changed to "uBlock₀ — Assets" in its tab
• Minor JS errors in dashboard
• Code exception in contentscript.js (vAPI.setTimeout) when opening Chrome last session tabs that are partly cached
• Element picker mishandles identifiers with backslashes
• Minor usability issue: block all scripts
• Toggle option changes are always permanent
• uBlock Origin doesn’t honor noscript tags when blocking JS

Commits history since 1.16.20.

See release notes.

I decided to create an emergency fix for a bug which was spotted for uMatrix but which also affects uBO:
"My rules tab hangs with cloud storage support"

If using cloud storage, there is a small probability uBO could be stuck in an infinite loop when reading back the data from the cloud storage, something which may occurs when the following conditions are reunited:

• You checked the setting "Enable cloud storage support";
• You saved data into the cloud storage for a given pane;
• The amount (in bytes) of data that was saved into the cloud storage for that given pane is rather high and such that the "chunkification" of that data results in a chunk count which is a multiple of 16;
  
  • Large amount of data is more likely for the "My filters" and "My rules" panes.
  • Sorry for the cryptic explanation, I don't know how else to describe this.
• You open the pane in the dashboard for which the conditions above are true.

If the bug is triggered, uBO could be stuck in an infinite loop in its main process, thus preventing it from doing its job.

This is not a regression, but rather a bug that has been hiding in there since quite a long time.

Commits history since 1.16.16.

See release notes.

I decided to create an emergency fix for a bug which was spotted for uMatrix but which also affects uBO:
"My rules tab hangs with cloud storage support"

If using cloud storage, there is a small probability uBO could be stuck in an infinite loop when reading back the data from the cloud storage, something which may occurs when the following conditions reunited:

• You checked the setting "Enable cloud storage support";
• You saved data into the cloud storage for a given pane;
• The amount (in bytes) of data that was saved into the cloud storage for that given pane is rather high and such that the "chunkification" of that data results in a chunk count which is a multiple of 16;
  
  • Large amount of data is more likely for the "My filters" and "My rules" panes.
  • Sorry for the cryptic explanation, I don't know how else to describe this.
• You open the pane in the dashboard for which the conditions above are true.

If the bug is triggered, uBO could be stuck in an infinite loop in its main process, thus preventing it from doing its job.

This is not a regression, but rather a bug that has been hiding in there since quite a long time.

Commits history since 1.16.16.

See release notes.


New

A new pane has been added in the dashboard for the Firefox version of uBO: Shortcuts. The purpose is to be able to assign keyboard shortcuts to some common operations.


Closed as fixed:

• Settings cannot be reset on Beta and Nightly Firefox
• Add a pane in the dashboard (Firefox only) to assign keyboard shortcuts
  
  • The new pane will be available for Firefox 60+ only.
    
• Element picker cannot be toggled before a site is fully loaded
• Logger: generic hiding rule recorded as active when $generichide in effect
• Filter for dynamically added class is not logged
• Logger: Popup which shows the used filter is empty

Commits history since 1.16.14.

See release notes.

Closed as fixed:

• Race condition at filter lists load time potentially breaking highly-generic cosmetic filters (https://github.com/gorhill/uBlock/commit/dcd98f4efa7876ae5d37bd0588082f6aecd08a30)
• Cursor jumps to next matched item when adding char to search<
• Inifinite update attempts with "AdGuard Experimental filter"
• Odd sorting in popup domains list when domains have same SLD but different TLD
• Cosmetic rules not logged for embedded YouTube videos

Commits history since 1.16.12.