deploy: update docs for v2.2.14

Author: Atlassian Bamboo

wiki/about-scriptlets.md

@@ -53,6 +53,7 @@
 - [prevent-eval-if](#prevent-eval-if)
 - [prevent-fab-3.2.0](#prevent-fab-3.2.0)
 - [prevent-fetch](#prevent-fetch)
+- [prevent-innerHTML](#prevent-innerhtml)
 - [prevent-popads-net](#prevent-popads-net)
 - [prevent-refresh](#prevent-refresh)
 - [prevent-requestAnimationFrame](#prevent-requestanimationframe)
@@ -2255,6 +2256,79 @@ example.org#%#//scriptlet('prevent-fetch'[, propsToMatch[, responseBody[, respon
 
 * * *
 
+## <a id="prevent-innerhtml"></a> ⚡️ prevent-innerHTML
+
+> Added in v2.2.14.
+
+Conditionally prevents assignment to `innerHTML` property
+and can replace the value returned by the getter.
+
+Related UBO scriptlet:
+https://github.com/gorhill/uBlock/wiki/Resources-Library#prevent-innerhtmljs-
+
+### Syntax
+
+```text
+example.org#%#//scriptlet('prevent-innerHTML'[, selector[, pattern[, replacement]]])
+```
+
+- `selector` — optional, CSS selector to match element. If not specified, matches all elements.
+- `pattern` — optional, string or regular expression to match against the assigned/returned value.
+  Prepend with `!` to invert the match. If not specified, matches all values.
+- `replacement` — optional, replacement value to return from getter when pattern matches.
+  If not specified, the getter returns the original value unchanged (setter-only mode).
+  If specified, enables getter manipulation mode. Possible values:
+    - empty string — `''`,
+    - custom text.
+
+### Examples
+
+1. Prevent any `innerHTML` assignment
+
+    ```adblock
+    example.org#%#//scriptlet('prevent-innerHTML')
+    ```
+
+1. Prevent `innerHTML` assignment on elements matching selector
+
+    ```adblock
+    example.org#%#//scriptlet('prevent-innerHTML', '#ads')
+    ```
+
+1. Prevent `innerHTML` assignment when the value contains "ad"
+
+    ```adblock
+    example.org#%#//scriptlet('prevent-innerHTML', '', 'ad')
+    ```
+
+1. Prevent `innerHTML` assignment on specific element when value matches regex
+
+    ```adblock
+    example.org#%#//scriptlet('prevent-innerHTML', 'div.ads', '/banner|sponsor/')
+    ```
+
+1. Prevent `innerHTML` assignment when value does NOT match pattern (inverted match)
+
+    ```adblock
+    example.org#%#//scriptlet('prevent-innerHTML', '', '!allowed-content')
+    ```
+
+1. Replace innerHTML getter value with empty string when it contains "delete window"
+
+    ```adblock
+    example.org#%#//scriptlet('prevent-innerHTML', '', 'delete window', '')
+    ```
+
+1. Replace innerHTML getter value with custom text when pattern matches
+
+    ```adblock
+    example.org#%#//scriptlet('prevent-innerHTML', 'div.code', '/evil-script/', 'safe-replacement')
+    ```
+
+[Scriptlet source](../src/scriptlets/prevent-innerHTML.ts)
+
+* * *
+
 ## <a id="prevent-popads-net"></a> ⚡️ prevent-popads-net
 
 > Added in v1.0.4.

wiki/about-trusted-scriptlets.md

@@ -28,12 +28,12 @@ and waiting for them to render in the DOM first.
 First matched element is clicked unless `containsText` is specified.
 If `containsText` is specified, then it searches for all given selectors and clicks
 the first element containing the specified text.
-Deactivates after all elements have been clicked or by 10s timeout.
+Deactivates after all elements have been clicked or by timeout (configurable).
 
 ### Syntax
 
 ```text
-example.com#%#//scriptlet('trusted-click-element', selectors[, extraMatch[, delay[, reload]]])
+example.com#%#//scriptlet('trusted-click-element', selectors[, extraMatch[, delay[, reload[, observerTimeout]]]])
 ```
 <!-- markdownlint-disable-next-line line-length -->
 - `selectors` — required, string with query selectors delimited by comma. The scriptlet supports `>>>` combinator to select elements inside open shadow DOM. For usage, see example below.
@@ -47,14 +47,18 @@ and each of them should match the syntax. Possible `names`:
     - `cookie` — test string or regex against cookies on a page
     - `localStorage` — check if localStorage item is present
     - `containsText` — check if clicked element contains specified text
-- `delay` — optional, time in ms to delay scriptlet execution, defaults to instant execution.
-            Must be a number less than 10000 ms (10s)
+- `delay` — optional, time in **ms** to delay scriptlet execution, defaults to instant execution.
+  Must be a number less than `observerTimeout` (default 10 _seconds_)
+  which can be configured.
 - `reload` — optional, string with reloadAfterClick marker and optional value. Possible values:
     - `reloadAfterClick` - reloads the page after all elements have been clicked,
        with default delay — 500ms
     - colon-separated pair `reloadAfterClick:value` where
         - `value` — time delay in milliseconds before reloading the page, after all elements
-           have been clicked. Must be a number less than 10000 ms (10s)
+           have been clicked. Must be a number less than `observerTimeout`.
+- `observerTimeout` — optional, time in **seconds** to use
+  instead default 10 seconds observer timeout.
+  Must be an integer number and more than 0.
 
 <!-- markdownlint-disable line-length -->
 
@@ -134,6 +138,12 @@ and each of them should match the syntax. Possible `names`:
    example.com#%#//scriptlet('trusted-click-element', 'button[name="agree"], button[name="check"], input[type="submit"][value="akkoord"]', '', '1000', 'reloadAfterClick:200')
    ```
 
+1. Extend observer timeout to 40 seconds to allow clicking elements that appear after user interaction
+
+   ```adblock
+   example.com#%#//scriptlet('trusted-click-element', 'button[name="agree"]', '', '', '', '40')
+   ```
+
 <!-- markdownlint-enable line-length -->
 
 [Scriptlet source](../src/scriptlets/trusted-click-element.ts)

wiki/compatibility-table.md

@@ -56,6 +56,7 @@
 | [prevent-eval-if](../wiki/about-scriptlets.md#prevent-eval-if) | noeval-if.js (prevent-eval-if.js) |  |
 | [prevent-fab-3.2.0](../wiki/about-scriptlets.md#prevent-fab-3.2.0) |  |  |
 | [prevent-fetch](../wiki/about-scriptlets.md#prevent-fetch) | prevent-fetch.js (no-fetch-if.js) |  |
+| [prevent-innerHTML](../wiki/about-scriptlets.md#prevent-innerHTML) | prevent-innerHTML |  |
 | [prevent-xhr](../wiki/about-scriptlets.md#prevent-xhr) | prevent-xhr.js (no-xhr-if.js) |  |
 | [prevent-popads-net](../wiki/about-scriptlets.md#prevent-popads-net) |  |  |
 | [prevent-refresh](../wiki/about-scriptlets.md#prevent-refresh) | prevent-refresh.js (refresh-defuser.js) |  |
@@ -183,3 +184,4 @@
 |  | noeval.js |  |
 |  | noop-0.5s.mp3 |  |
 |  | sensors-analytics.js |  |
+|  | nitropay_ads.js |  |