[BETA] Userscripts v4.2.0 (macOS), v1.2.0 (iOS)

[quoid]

Userscripts v4.2.0 (macOS), v1.2.0 (iOS)

• [macOS] enable basic userscript linting when javascript linter running in extension page editor - Lint Userscript Metadata #132
• [macOS/iOS] changed CSS injection to use browser.tabs.insertCSS(), this should circumvent CSP blocking - Use tabs.insertCSS() for css injection #151
• [macOS/iOS] injection refactoring and optimizations - moved a lot of logic out of content script and into background script, minor performance improvements, major code maintainability improvements - Investigate Faster Injection #184
• [macOS/iOS] enable support for dynamic declarativeNetRequest (content blocking) userscripts using @run-at request
• [macOS/iOS] fix var naming conflict - Variable naming conflict causes script to fail to run #237
• [macOS/iOS] misc code/style fixes

Version 4.2 bring support for a new type of userscript that uses the declarativeNetRequest API. You can read more about that API here. To create a "request userscript" simply use the following key/val in your userscript @run-at request and provide a valid rule under the userscript metadata.

Notes:

• The onus is on the user to know the declarativeNetRequest API, there is little to no error checking of user supplied rules. If you supply a rule, the extension will attempt to load it. If the syntax is incorrect, errors will occur.
• When a userscript has @run-at request it is loaded on browser startup and matching metadata fields do not affect the userscript (ie. @include/match/exclude/exclude-match)
• The declarativeNetRequest rules persist for the session and are loaded on browser startup. The rules are refreshed when the popup opens as well. That means if you save a new declarativeNetRequest userscript, you must open the popup at least once to have it indexed. That means if you disable a declarativeNetRequest userscript, you must open the popup at least once to have that change take effect - more triggers coming soon.
• rule ids must be unique and it is up to the user to ensure they have supplied unique id values at the current time (this might change in the future)

Example declarativeNetRequest userscript:

// ==UserScript==
// @name        Reddit Redirect
// @description Redirects all Reddit requests to the old version of the website
// @run-at request
// ==/UserScript==

{
    "id": 6,
    "priority": 1,
    "action": {
        "type": "redirect",
        "redirect": {
            "transform": { "scheme": "https", "host": "old.reddit.com" }
        }
    },
    "condition": { "urlFilter": "||reddit.com", "resourceTypes": ["main_frame"] }
}

This is only supported in Safari 15.4 and beyond.

[quoid]

Build 49

• [macOS/iOS] declarativeNetRequest userscripts now support arrays rather than a single rule object (example below)
• [macOS/iOS] rules in declarativeNetRequest userscripts have their id number rewritten when loading into the session
  • this was added to make it easier to manage declarativeNetRequest userscript rules across multiple userscripts
  • since declarativeNetRequest rule ids must be unique, this change will reduce the amount of conflicts users see
• [macOS] declarativeNetRequest userscripts are reloaded into the session when a save event occurs in the built in editor, where the userscript being saved has @run-at request

// ==UserScript==
// @name        Multi Rule
// @description This is your new file, start writing code
// @run-at request
// ==/UserScript==

[
    {
           "id": 97,
           "priority": 1,
           "action": { "type": "block" },
           "condition": {"urlFilter": "||google.com", "resourceTypes": ["image"] }
    },
    {
           "id": 98,
           "priority": 1,
           "action": { "type": "block" },
           "condition": {"urlFilter": "bing", "resourceTypes": ["image"] }
    }
]

[quoid]

Build 50

• [macOS/iOS] fix getValue default value bug (thanks @elyscape) - Support falsey default values in getValue() #241
• [macOS/iOS] style updates to iphone/ipad popup to resolve unreachable buttons- Sometimes you can't click the installation button. #243
• [macOS/iOS] fix url parsing to resolve invalid matching - Pattern that match the URL is not rigorous, resulting in @match may not be correctly matched #249

[quoid]

macOS Build 51 / iOS Build 23

• [iOS] more style updates to iphone/ipad popup to resolve unreachable buttons- Sometimes you can't click the installation button. #243

[quoid]

macOS Build 52 / iOS Build 24

• [macOS] updated and re-implemented @run-at context-menu userscripts - Context Menu Injection Updates #159
• [macOS/iOS] changed the frequency at which declarativeNetRequest scripts get updated

[quoid]

released: https://github.com/quoid/userscripts/releases/tag/v4.2.0