about-scriptlets.md

# <a id="scriptlets"></a> Available Scriptlets

- [abort-current-inline-script](#abort-current-inline-script)
- [abort-on-property-read](#abort-on-property-read)
- [abort-on-property-write](#abort-on-property-write)
- [abort-on-stack-trace](#abort-on-stack-trace)
- [adjust-setInterval](#adjust-setinterval)
- [adjust-setTimeout](#adjust-settimeout)
- [amazon-apstag](#amazon-apstag)
- [call-nothrow](#call-nothrow)
- [close-window](#close-window)
- [debug-current-inline-script](#debug-current-inline-script)
- [debug-on-property-read](#debug-on-property-read)
- [debug-on-property-write](#debug-on-property-write)
- [didomi-loader](#didomi-loader)
- [dir-string](#dir-string)
- [disable-newtab-links](#disable-newtab-links)
- [evaldata-prune](#evaldata-prune)
- [fingerprintjs2](#fingerprintjs2)
- [fingerprintjs3](#fingerprintjs3)
- [freewheel-admanager](#freewheel-admanager)
- [gemius](#gemius)
- [google-analytics-ga](#google-analytics-ga)
- [google-analytics](#google-analytics)
- [google-ima3-dai](#google-ima3-dai)
- [google-ima3](#google-ima3)
- [googlesyndication-adsbygoogle](#googlesyndication-adsbygoogle)
- [googletagservices-gpt](#googletagservices-gpt)
- [hide-in-shadow-dom](#hide-in-shadow-dom)
- [href-sanitizer](#href-sanitizer)
- [inject-css-in-shadow-dom](#inject-css-in-shadow-dom)
- [json-prune-fetch-response](#json-prune-fetch-response)
- [json-prune-xhr-response](#json-prune-xhr-response)
- [json-prune](#json-prune)
- [log-addEventListener](#log-addeventlistener)
- [log-eval](#log-eval)
- [log-on-stack-trace](#log-on-stack-trace)
- [log](#log)
- [m3u-prune](#m3u-prune)
- [matomo](#matomo)
- [metrika-yandex-tag](#metrika-yandex-tag)
- [metrika-yandex-watch](#metrika-yandex-watch)
- [naver-wcslog](#naver-wcslog)
- [no-protected-audience](#no-protected-audience)
- [no-topics](#no-topics)
- [noeval](#noeval)
- [nowebrtc](#nowebrtc)
- [pardot-1.0](#pardot-1.0)
- [prebid](#prebid)
- [prevent-addEventListener](#prevent-addeventlistener)
- [prevent-adfly](#prevent-adfly)
- [prevent-bab](#prevent-bab)
- [prevent-canvas](#prevent-canvas)
- [prevent-constructor](#prevent-constructor)
- [prevent-element-src-loading](#prevent-element-src-loading)
- [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-navigation](#prevent-navigation)
- [prevent-popads-net](#prevent-popads-net)
- [prevent-refresh](#prevent-refresh)
- [prevent-requestAnimationFrame](#prevent-requestanimationframe)
- [prevent-setInterval](#prevent-setinterval)
- [prevent-setTimeout](#prevent-settimeout)
- [prevent-window-open](#prevent-window-open)
- [prevent-xhr](#prevent-xhr)
- [remove-attr](#remove-attr)
- [remove-class](#remove-class)
- [remove-cookie](#remove-cookie)
- [remove-in-shadow-dom](#remove-in-shadow-dom)
- [remove-node-text](#remove-node-text)
- [remove-request-query-parameter](#remove-request-query-parameter)
- [scorecardresearch-beacon](#scorecardresearch-beacon)
- [set-attr](#set-attr)
- [set-constant](#set-constant)
- [set-cookie-reload](#set-cookie-reload)
- [set-cookie](#set-cookie)
- [set-local-storage-item](#set-local-storage-item)
- [set-popads-dummy](#set-popads-dummy)
- [set-session-storage-item](#set-session-storage-item)
- [spoof-css](#spoof-css)
- [xml-prune](#xml-prune)

* * *

## <a id="abort-current-inline-script"></a> ⚡️ abort-current-inline-script

> Added in v1.0.4.

Aborts an inline script when it attempts to **read** or **write to** the specified property
AND when the contents of the `<script>` element contains the specified
text or matches the regular expression.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#abort-current-inline-scriptjs-

Related ABP source:
https://gitlab.com/eyeo/snippets/-/blob/main/source/behavioral/abort-current-inline-script.js

### Syntax

```text
example.org#%#//scriptlet('abort-current-inline-script', property[, search])
```

- `property` — required, path to a property (joined with `.` if needed). The property must be attached to `window`
- `search` — optional, string or regular expression that must match the inline script content.
  Defaults to abort all scripts which are trying to access the specified property.
  Invalid regular expression will cause exit and rule will not work.

> Note please that to abort the inline script with addEventListener in it,
> `property` should be set as `EventTarget.prototype.addEventListener`, not just `addEventListener`.

### Examples

1. Aborts all inline scripts trying to access `window.alert`

    ```adblock
    example.org#%#//scriptlet('abort-current-inline-script', 'alert')
    ```

1. Aborts inline scripts which are trying to access `window.alert` and contain `Hello, world`

    ```adblock
    example.org#%#//scriptlet('abort-current-inline-script', 'alert', 'Hello, world')
    ```

    For instance, the following script will be aborted:

    ```html
    <script>alert("Hello, world");</script>
    ```

1. Aborts inline scripts which are trying to access `window.alert` and match regexp `/Hello.+world/`

    ```adblock
    example.org#%#//scriptlet('abort-current-inline-script', 'alert', '/Hello.+world/')
    ```

    For instance, the following scripts will be aborted:

    ```html
    <script>alert("Hello, big world");</script>
    ```

    ```html
    <script>alert("Hello, little world");</script>
    ```

    And this script will not be aborted:

    ```html
    <script>alert("Hi, little world");</script>
    ```

[Scriptlet source](../src/scriptlets/abort-current-inline-script.js)

* * *

## <a id="abort-on-property-read"></a> ⚡️ abort-on-property-read

> Added in v1.0.4.

Aborts a script when it attempts to **read** the specified property.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#abort-on-property-readjs-

Related ABP source:
https://gitlab.com/eyeo/snippets/-/blob/main/source/behavioral/abort-on-property-read.js

### Syntax

```text
example.org#%#//scriptlet('abort-on-property-read', property)
```

- `property` — required, path to a property (joined with `.` if needed). The property must be attached to `window`

### Examples

```adblock
! Aborts script when it tries to access `window.alert`
example.org#%#//scriptlet('abort-on-property-read', 'alert')

! Aborts script when it tries to access `navigator.language`
example.org#%#//scriptlet('abort-on-property-read', 'navigator.language')
```

[Scriptlet source](../src/scriptlets/abort-on-property-read.js)

* * *

## <a id="abort-on-property-write"></a> ⚡️ abort-on-property-write

> Added in v1.0.4.

Aborts a script when it attempts to **write** the specified property.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#abort-on-property-writejs-

Related ABP source:
https://gitlab.com/eyeo/snippets/-/blob/main/source/behavioral/abort-on-property-write.js

### Syntax

```text
example.org#%#//scriptlet('abort-on-property-write', property)
```

- `property` — required, path to a property (joined with `.` if needed).
  The property must be attached to `window`

### Examples

```adblock
! Aborts script when it tries to set `window.adblock` value
example.org#%#//scriptlet('abort-on-property-write', 'adblock')
```

[Scriptlet source](../src/scriptlets/abort-on-property-write.js)

* * *

## <a id="abort-on-stack-trace"></a> ⚡️ abort-on-stack-trace

> Added in v1.5.0.

Aborts a script when it attempts to utilize (read or write to) the specified property
and it's error stack trace contains given value.

Related UBO scriptlet:
https://github.com/gorhill/uBlock-for-firefox-legacy/commit/7099186ae54e70b588d5e99554a05d783cabc8ff

### Syntax

```text
example.com#%#//scriptlet('abort-on-stack-trace', property, stack)
```

- `property` — required, path to a property. The property must be attached to window.
- `stack` — required, string that must match the current function call stack trace.
    - values to abort inline or injected script, accordingly:
        - `inlineScript`
        - `injectedScript`

### Examples

1. Aborts script when it tries to access `window.Ya` and it's error stack trace contains `test.js`

    ```adblock
    example.org#%#//scriptlet('abort-on-stack-trace', 'Ya', 'test.js')
    ```

1. Aborts script when it tries to access `window.Ya.videoAd` and it's error stack trace contains `test.js`

    ```adblock
    example.org#%#//scriptlet('abort-on-stack-trace', 'Ya.videoAd', 'test.js')
    ```

1. Aborts script when stack trace matches with any of these parameters

    ```adblock
    example.org#%#//scriptlet('abort-on-stack-trace', 'Ya', 'yandexFuncName')
    example.org#%#//scriptlet('abort-on-stack-trace', 'Ya', 'yandexScriptName')
    ```

1. Aborts script when it tries to access `window.Ya` and it's an inline script

    ```adblock
    example.org#%#//scriptlet('abort-on-stack-trace', 'Ya', 'inlineScript')
    ```

1. Aborts script when it tries to access `window.Ya` and it's an injected script

     ```adblock
     example.org#%#//scriptlet('abort-on-stack-trace', 'Ya', 'injectedScript')
     ```

[Scriptlet source](../src/scriptlets/abort-on-stack-trace.js)

* * *

## <a id="adjust-setinterval"></a> ⚡️ adjust-setInterval

> Added in v1.0.4.

Adjusts delay for specified setInterval() callbacks.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#nano-setinterval-boosterjs-

### Syntax

```text
example.org#%#//scriptlet('adjust-setInterval'[, matchCallback [, matchDelay[, boost]]])
```

- `matchCallback` — optional, string or regular expression for stringified callback matching;
  defaults to match all callbacks; invalid regular expression will cause exit and rule will not work
- `matchDelay` — optional, defaults to 1000, matching setInterval delay; decimal integer OR '*' for any delay
- `boost` — optional, default to 0.05, float,
  capped at 1000 times for up and 50 for down (0.001...50), setInterval delay multiplier

### Examples

1. Adjust all setInterval() x20 times where delay equal 1000ms

    ```adblock
    example.org#%#//scriptlet('adjust-setInterval')
    ```

1. Adjust all setInterval() x20 times where callback matched with `example` and delay equal 1000ms

    ```adblock
    example.org#%#//scriptlet('adjust-setInterval', 'example')
    ```

1. Adjust all setInterval() x20 times where callback matched with `example` and delay equal 400ms

    ```adblock
    example.org#%#//scriptlet('adjust-setInterval', 'example', '400')
    ```

1. Slow down setInterval() x2 times where callback matched with `example` and delay equal 1000ms

    ```adblock
    example.org#%#//scriptlet('adjust-setInterval', 'example', '', '2')
    ```

1. Adjust all setInterval() x50 times where delay equal 2000ms

    ```adblock
    example.org#%#//scriptlet('adjust-setInterval', '', '2000', '0.02')
    ```

1. Adjust all setInterval() x1000 times where delay equal 2000ms

    ```adblock
    example.org#%#//scriptlet('adjust-setInterval', '', '2000', '0.001')
    ```

1. Adjust all setInterval() x50 times where delay is randomized

    ```adblock
    example.org#%#//scriptlet('adjust-setInterval', '', '*', '0.02')
    ```

[Scriptlet source](../src/scriptlets/adjust-setInterval.js)

* * *

## <a id="adjust-settimeout"></a> ⚡️ adjust-setTimeout

> Added in v1.0.4.

Adjusts delay for specified setTimeout() callbacks.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#nano-settimeout-boosterjs-

### Syntax

```text
example.org#%#//scriptlet('adjust-setTimeout'[, matchCallback [, matchDelay[, boost]]])
```

- `matchCallback` — optional, string or regular expression for stringified callback matching;
  defaults to match all callbacks; invalid regular expression will cause exit and rule will not work
- `matchDelay` — optional, defaults to 1000, matching setTimeout delay; decimal integer OR '*' for any delay
- `boost` — optional, default to 0.05, float,
  capped at 1000 times for up and 50 for down (0.001...50), setTimeout delay multiplier

### Examples

1. Adjust all setTimeout() x20 times where timeout equal 1000ms

    ```adblock
    example.org#%#//scriptlet('adjust-setTimeout')
    ```

1. Adjust all setTimeout() x20 times where callback matched with `example` and timeout equal 1000ms

    ```adblock
    example.org#%#//scriptlet('adjust-setTimeout', 'example')
    ```

1. Adjust all setTimeout() x20 times where callback matched with `example` and timeout equal 400ms

    ```adblock
    example.org#%#//scriptlet('adjust-setTimeout', 'example', '400')
    ```

1. Slow down setTimeout() x2 times where callback matched with `example` and timeout equal 1000ms

    ```adblock
    example.org#%#//scriptlet('adjust-setTimeout', 'example', '', '2')
    ```

1. Adjust all setTimeout() x50 times where timeout equal 2000ms

    ```adblock
    example.org#%#//scriptlet('adjust-setTimeout', '', '2000', '0.02')
    ```

1. Adjust all setTimeout() x1000 times where timeout equal 2000ms

    ```adblock
    example.org#%#//scriptlet('adjust-setTimeout', '', '2000', '0.001')
    ```

1. Adjust all setTimeout() x20 times where callback matched with `test` and timeout is randomized

    ```adblock
    example.org#%#//scriptlet('adjust-setTimeout', 'test', '*')
    ```

[Scriptlet source](../src/scriptlets/adjust-setTimeout.js)

* * *

## <a id="amazon-apstag"></a> ⚡️ amazon-apstag

> Added in v1.10.25.

Mocks Amazon's apstag.js

### Examples

```adblock
example.org#%#//scriptlet('amazon-apstag')
```

[Scriptlet source](../src/scriptlets/amazon-apstag.ts)

* * *

## <a id="call-nothrow"></a> ⚡️ call-nothrow

> Added in v1.10.1.

Prevents an exception from being thrown and returns undefined when a specific function is called.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#call-nothrowjs-

### Syntax

```text
example.org#%#//scriptlet('call-nothrow', functionName)
```

- `functionName` — required, the name of the function to trap

### Examples

1. Prevents an exception from being thrown when `Object.defineProperty` is called:

    ```adblock
    example.org#%#//scriptlet('call-nothrow', 'Object.defineProperty')
    ```

    For instance, the following call normally throws an error, but the scriptlet catches it and returns undefined:

    ```javascript
    Object.defineProperty(window, 'foo', { value: true });
    Object.defineProperty(window, 'foo', { value: false });
    ```

2. Prevents an exception from being thrown when `JSON.parse` is called:

    ```adblock
    example.org#%#//scriptlet('call-nothrow', 'JSON.parse')
    ```

    For instance, the following call normally throws an error, but the scriptlet catches it and returns undefined:

    ```javascript
    JSON.parse('foo');
    ```

[Scriptlet source](../src/scriptlets/call-nothrow.js)

* * *

## <a id="close-window"></a> ⚡️ close-window

> Added in v1.5.0.

Closes the browser tab immediately.

> `window.close()` usage is restricted in the Chrome browser.
> In this case tab will only be closed when using AdGuard Browser extension.

### Syntax

```text
example.org#%#//scriptlet('close-window'[, path])
```

- `path` — optional, string or regular expression
  matching the current location's path: `window.location.pathname` + `window.location.search`.
  Defaults to execute on every page.

### Examples

```adblock
! closes any example.org tab
example.org#%#//scriptlet('close-window')

! closes specific example.org tab
example.org#%#//scriptlet('close-window', '/example-page.html')
```

[Scriptlet source](../src/scriptlets/close-window.js)

* * *

## <a id="debug-current-inline-script"></a> ⚡️ debug-current-inline-script

> Added in v1.0.4.

This scriptlet is basically the same as [abort-current-inline-script](#abort-current-inline-script),
but instead of aborting it starts the debugger.

> It is not allowed for prod versions of filter lists.

### Examples

1. Debug script when it tries to access `window.alert`

    ```adblock
    example.org#%#//scriptlet('debug-current-inline-script', 'alert')
    ```

[Scriptlet source](../src/scriptlets/debug-current-inline-script.js)

* * *

## <a id="debug-on-property-read"></a> ⚡️ debug-on-property-read

> Added in v1.0.4.

This scriptlet is basically the same as [abort-on-property-read](#abort-on-property-read),
but instead of aborting it starts the debugger.

> It is not allowed for prod versions of filter lists.

### Examples

1. Debug script if it tries to access `window.alert`

    ```adblock
    example.org#%#//scriptlet('debug-on-property-read', 'alert')
    ```

1. Debug script if it tries to access `window.open`

    ```adblock
    example.org#%#//scriptlet('debug-on-property-read', 'open')
    ```

[Scriptlet source](../src/scriptlets/debug-on-property-read.js)

* * *

## <a id="debug-on-property-write"></a> ⚡️ debug-on-property-write

> Added in v1.0.4.

This scriptlet is basically the same as [abort-on-property-write](#abort-on-property-write),
but instead of aborting it starts the debugger.

> It is not allowed for prod versions of filter lists.

### Examples

1. Debug script when it tries to write in property `window.test`

    ```adblock
    example.org#%#//scriptlet('debug-on-property-write', 'test')
    ```

[Scriptlet source](../src/scriptlets/debug-on-property-write.js)

* * *

## <a id="didomi-loader"></a> ⚡️ didomi-loader

> Added in v1.10.25.

Mocks Didomi's CMP loader script.
https://developers.didomi.io/

### Examples

```adblock
example.org#%#//scriptlet('didomi-loader')
```

[Scriptlet source](../src/scriptlets/didomi-loader.ts)

* * *

## <a id="dir-string"></a> ⚡️ dir-string

> Added in v1.0.4.

Wraps the `console.dir` API to call the `toString` method of the argument.
There are several adblock circumvention systems that detect browser devtools
and hide themselves. Therefore, if we force them to think
that devtools are open (using this scriptlet),
it will automatically disable the adblock circumvention script.

### Syntax

```text
example.org#%#//scriptlet('dir-string'[, times])
```

- `times` — optional, the number of times to call the `toString` method of the argument to `console.dir`

### Examples

```adblock
! Run 2 times
example.org#%#//scriptlet('dir-string', '2')
```

[Scriptlet source](../src/scriptlets/dir-string.js)

* * *

## <a id="disable-newtab-links"></a> ⚡️ disable-newtab-links

> Added in v1.0.4.

Prevents opening new tabs and windows if there is `target` attribute in element.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#disable-newtab-linksjs-

### Syntax

```adblock
example.org#%#//scriptlet('disable-newtab-links')
```

[Scriptlet source](../src/scriptlets/disable-newtab-links.ts)

* * *

## <a id="evaldata-prune"></a> ⚡️ evaldata-prune

> Added in v1.9.37.

Removes specified properties from the result of calling eval (if payloads contains `Object`) and returns to the caller.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/commit/c8de9041917b61035171e454df886706f27fc4f3

### Syntax

```text
example.org#%#//scriptlet('evaldata-prune'[, propsToRemove [, obligatoryProps [, stack]]])
```

- `propsToRemove` — optional, string of space-separated properties to remove.
- `obligatoryProps` — optional, string of space-separated properties
  which must be all present for the pruning to occur
- `stack` — optional, string or regular expression that must match the current function call stack trace;
  if regular expression is invalid it will be skipped

> Note please that you can use wildcard `*` for chain property name,
> e.g. `ad.*.src` instead of `ad.0.src ad.1.src ad.2.src`.

### Examples

1. Removes property `example` from the payload of the eval call

    ```adblock
    example.org#%#//scriptlet('evaldata-prune', 'example')
    ```

    For instance, the following call will return `{ one: 1}`

    ```html
    eval({ one: 1, example: true })
    ```

2. If there are no specified properties in the payload of eval call, pruning will NOT occur

    ```adblock
    example.org#%#//scriptlet('evaldata-prune', 'one', 'obligatoryProp')
    ```

    For instance, the following call will return `{ one: 1, two: 2}`

    ```html
    JSON.parse('{"one":1,"two":2}')
    ```

3. A property in a list of properties can be a chain of properties

    ```adblock
    example.org#%#//scriptlet('evaldata-prune', 'a.b', 'ads.url.first')
    ```

4. Removes property `content.ad` from the payload of eval call if its error stack trace contains `test.js`

    ```adblock
    example.org#%#//scriptlet('evaldata-prune', 'content.ad', '', 'test.js')
    ```

5. A property in a list of properties can be a chain of properties with wildcard in it

    ```adblock
    example.org#%#//scriptlet('evaldata-prune', 'content.*.media.src', 'content.*.media.ad')
    ```

6. Call with no arguments will log the current hostname and object payload at the console

    ```adblock
    example.org#%#//scriptlet('evaldata-prune')
    ```

7. Call with only second argument will log the current hostname and matched object payload at the console

    ```adblock
    example.org#%#//scriptlet('evaldata-prune', '', '"id":"117458"')
    ```

[Scriptlet source](../src/scriptlets/evaldata-prune.js)

* * *

## <a id="fingerprintjs2"></a> ⚡️ fingerprintjs2

> Added in v1.10.25.

Mocks FingerprintJS v2
https://github.com/fingerprintjs

### Examples

```adblock
example.org#%#//scriptlet('fingerprintjs2')
```

[Scriptlet source](../src/scriptlets/fingerprintjs2.ts)

* * *

## <a id="fingerprintjs3"></a> ⚡️ fingerprintjs3

> Added in v1.10.25.

Mocks FingerprintJS v3
https://github.com/fingerprintjs

### Examples

```adblock
example.org#%#//scriptlet('fingerprintjs3')
```

[Scriptlet source](../src/scriptlets/fingerprintjs3.ts)

* * *

## <a id="freewheel-admanager"></a> ⚡️ freewheel-admanager

> Added in v2.3.0.

Mocks the FreeWheel Ad Manager.

### Examples

```adblock
example.org#%#//scriptlet('freewheel-admanager')
```

[Scriptlet source](../src/scriptlets/freewheel-admanager.ts)

* * *

## <a id="gemius"></a> ⚡️ gemius

> Added in v1.10.25.

Mocks Gemius Analytics.
https://flowplayer.com/developers/plugins/gemius

### Examples

```adblock
example.org#%#//scriptlet('gemius')
```

[Scriptlet source](../src/scriptlets/gemius.ts)

* * *

## <a id="google-analytics-ga"></a> ⚡️ google-analytics-ga

> Added in v1.10.25.

Mocks old Google Analytics API.

### Examples

```adblock
example.org#%#//scriptlet('google-analytics-ga')
```

[Scriptlet source](../src/scriptlets/google-analytics-ga.ts)

* * *

## <a id="google-analytics"></a> ⚡️ google-analytics

> Added in v1.10.25.

Mocks Google's Analytics and Tag Manager APIs.

### Examples

```adblock
example.org#%#//scriptlet('google-analytics')
```

[Scriptlet source](../src/scriptlets/google-analytics.ts)

* * *

## <a id="google-ima3-dai"></a> ⚡️ google-ima3-dai

> Added in v2.4.2.

Mocks the IMA DAI SDK of Google.

### Examples

```adblock
example.org#%#//scriptlet('google-ima3-dai')
```

[Scriptlet source](../src/scriptlets/google-ima3-dai.ts)

* * *

## <a id="google-ima3"></a> ⚡️ google-ima3

> Added in v1.10.25.

Mocks the IMA SDK of Google.

### Examples

```adblock
example.org#%#//scriptlet('google-ima3')
```

[Scriptlet source](../src/scriptlets/google-ima3.ts)

* * *

## <a id="googlesyndication-adsbygoogle"></a> ⚡️ googlesyndication-adsbygoogle

> Added in v1.10.25.

Mocks Google AdSense API.

### Examples

```adblock
example.org#%#//scriptlet('googlesyndication-adsbygoogle')
```

[Scriptlet source](../src/scriptlets/googlesyndication-adsbygoogle.ts)

* * *

## <a id="googletagservices-gpt"></a> ⚡️ googletagservices-gpt

> Added in v1.10.25.

Mocks Google Publisher Tag API.

### Examples

```adblock
example.org#%#//scriptlet('googletagservices-gpt')
```

[Scriptlet source](../src/scriptlets/googletagservices-gpt.ts)

* * *

## <a id="hide-in-shadow-dom"></a> ⚡️ hide-in-shadow-dom

> Added in v1.3.0.

Hides elements inside open shadow DOM elements.

### Syntax

```text
example.org#%#//scriptlet('hide-in-shadow-dom', selector[, baseSelector])
```

- `selector` — required, CSS selector of element in shadow-dom to hide
- `baseSelector` — optional, selector of specific page DOM element,
  narrows down the part of the page DOM where shadow-dom host supposed to be,
  defaults to document.documentElement

> `baseSelector` should match element of the page DOM, but not of shadow DOM.

### Examples

```adblock
! hides menu bar
example.com#%#//scriptlet('hide-in-shadow-dom', '.storyAd', '#app')

! hides floating element
example.com#%#//scriptlet('hide-in-shadow-dom', '.contact-fab')
```

[Scriptlet source](../src/scriptlets/hide-in-shadow-dom.js)

* * *

## <a id="href-sanitizer"></a> ⚡️ href-sanitizer

> Added in v1.10.25.

Set the `href` attribute to a value found in text content of the targeted `a` element,
or in an attribute of the targeted `a` element,
or in a URL parameter of the targeted `a` element's `href` attribute.
This scriptlet runs once when the page loads and after that on DOM tree changes.

Related UBO scriptlet:
https://github.com/uBlockOrigin/uBlock-issues/wiki/Resources-Library#href-sanitizerjs-

### Syntax

```text
example.org#%#//scriptlet('href-sanitizer', selector[, attribute[, transform]])
```

- `selector` — required, a CSS selector to match the elements to be sanitized,
  which should be anchor elements (`<a>`) with `href` attribute.
- `attribute` — optional, default to `text`:
    - `text` — use the text content of the matched element,
    - `[<attribute-name>]` copy the value from attribute `attribute-name` on the same element,
    - `?<parameter-name>` copy the value from URL parameter `parameter-name` of the same element's `href` attribute.
- `transform` — optional, defaults to no transforming. Possible values:
    - `base64decode` — decode the base64 string from specified attribute.
      `-base64` can be used as an alias.
    - `removeHash` — remove the hash from the URL.
    - `removeParam[:<parameters>]` — remove the specified parameters from the URL,
      where `<parameters>` is a comma-separated list of parameter names;
      if no parameter is specified, remove all parameters.

> Note that in the case where the discovered value does not correspond to a valid URL with the appropriate
> HTTP or HTTPS protocols, the value will not be set.

### Examples

1. Set the `href` attribute to a value found in text content of the targeted `a` element:

    ```adblock
    example.org#%#//scriptlet('href-sanitizer', 'a[href*="foo.com"]')
    ```

    ```html
    <!-- before -->
    <div>
        <a href="https://foo.com/bar">https://example.org/test?foo</a>
    </div>

    <!-- after -->
    <div>
        <a href="https://example.org/test?foo">https://example.org/test?foo</a>
    </div>
    ```

2. Set the `href` attribute to a value found in an attribute of the targeted `a` element:

    ```adblock
    example.org#%#//scriptlet('href-sanitizer', 'a[href*="foo.com"]', '[data-href]')
    ```

    ```html
    <!-- before -->
    <div>
        <a href="https://foo.com/bar" data-href="https://example.org/test?foo"></a>
    </div>

    <!-- after -->
    <div>
        <a href="https://example.org/test?foo" data-href="https://example.org/test?foo"></a>
    </div>
    ```

3. Set the `href` attribute to a value found in a URL parameter of the targeted `a` element's `href` attribute:

    ```adblock
    example.org#%#//scriptlet('href-sanitizer', 'a[href*="tracker.com"]', '?redirect')
    ```

    ```html
    <!-- before -->
    <div>
        <a href="https://tracker.com/foo?redirect=https://example.org/"></a>
    </div>

    <!-- after -->
    <div>
        <a href="https://example.org/"></a>
    </div>
    ```

4. Decode the base64 string from specified attribute:

    ```adblock
    example.org#%#//scriptlet('href-sanitizer', 'a[href*="foo.com"]', '[href]', 'base64decode')
    ```

    ```html
    <!-- before -->
    <div>
        <a href="http://www.foo.com/out/?aHR0cDovL2V4YW1wbGUuY29tLz92PTEyMw=="></a>
    </div>

    <!-- after -->
    <div>
        <a href="http://example.com/?v=123"></a>
    </div>
    ```

5. Remove the hash from the URL:

    ```adblock
    example.org#%#//scriptlet('href-sanitizer', 'a[href*="foo.com"]', '[href]', 'removeHash')
    ```

    ```html
    <!-- before -->
    <div>
        <a href="http://www.foo.com/out/#aHR0cDovL2V4YW1wbGUuY29tLz92PTEyMw=="></a>
    </div>

    <!-- after -->
    <div>
        <a href="http://www.foo.com/out/"></a>
    </div>
    ```

6. Remove the all parameter(s) from the URL:

    ```adblock
    example.org#%#//scriptlet('href-sanitizer', 'a[href*="foo.com"]', '[href]', 'removeParam')
    ```

    ```html
    <!-- before -->
    <div>
        <a href="https://foo.com/123123?utm_source=nova&utm_medium=tg&utm_campaign=main"></a>
    </div>

    <!-- after -->
    <div>
        <a href="https://foo.com/123123"></a>
    </div>
    ```

7. Remove the specified parameter(s) from the URL:

    ```adblock
    example.org#%#//scriptlet('href-sanitizer', 'a[href*="foo.com"]', '[href]', 'removeParam:utm_source,utm_medium')
    ```

    ```html
    <!-- before -->
    <div>
        <a href="https://foo.com/123123?utm_source=nova&utm_medium=tg&utm_campaign=main"></a>
    </div>

    <!-- after -->
    <div>
        <a href="https://foo.com/123123?utm_campaign=main"></a>
    </div>
    ```

[Scriptlet source](../src/scriptlets/href-sanitizer.ts)

* * *

## <a id="inject-css-in-shadow-dom"></a> ⚡️ inject-css-in-shadow-dom

> Added in v1.8.2.

Injects CSS rule into selected Shadow DOM subtrees on a page.

### Syntax

```text
example.org#%#//scriptlet('inject-css-in-shadow-dom', cssRule[, hostSelector[, cssInjectionMethod]])
```

- `cssRule` — required, string representing a single CSS rule.
- `hostSelector` — optional, string, selector to match shadow host elements.
  CSS rule will be only applied to shadow roots inside these elements.
  Defaults to injecting CSS rule into all available roots.
- `cssInjectionMethod` — optional, string, method to inject CSS rule into shadow DOM.
  Available methods are:
    - `adoptedStyleSheets` — injects the CSS rule using adopted style sheets (default option).
    - `styleTag` — injects the CSS rule using a `style` tag.

### Examples

1. Apply style to all shadow DOM subtrees:

    ```adblock
    example.org#%#//scriptlet('inject-css-in-shadow-dom', '#advertisement { display: none !important; }')
    ```

1. Apply style to a specific shadow DOM subtree:

    ```adblock
    example.org#%#//scriptlet('inject-css-in-shadow-dom', '#content { margin-top: 0 !important; }', '#banner')
    ```

1. Apply style to all shadow DOM subtrees using style tag:

   ```adblock
   example.org#%#//scriptlet('inject-css-in-shadow-dom', '.ads { display: none !important; }', '', 'styleTag')
   ```

[Scriptlet source](../src/scriptlets/inject-css-in-shadow-dom.js)

* * *

## <a id="json-prune-fetch-response"></a> ⚡️ json-prune-fetch-response

> Added in v1.10.25.

Removes specified properties from the JSON response of a fetch call.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/commit/749cec0f095f659d6c0b90eb89b729e9deb07c87

### Syntax

<!-- markdownlint-disable line-length -->

```text
example.org#%#//scriptlet('json-prune-fetch-response'[, propsToRemove[, obligatoryProps[, propsToMatch[, stack[, mode]]]]])
```

<!-- markdownlint-enable line-length -->

- `propsToRemove` — optional, string of space-separated properties to remove.
  In `jsonpath` mode only single JSONPath prune expression is supported.
- `obligatoryProps` — optional, string of space-separated properties
  which must be all present for the pruning to occur.
- `propsToMatch` — optional, string of space-separated properties to match; possible props:
    - String or regular expression for matching the URL passed to fetch call;
      empty string, wildcard `*` or invalid regular expression will match all fetch calls.
    - Colon-separated pairs `name:value` where:
        <!-- markdownlint-disable-next-line line-length -->
        - `name` is [`init` option name](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch#parameters).
        - `value` is string or regular expression for matching the value of the option passed to fetch call;
          invalid regular expression will cause any value matching.
- `stack` — optional, string or regular expression that must match the current function call stack trace;
  if regular expression is invalid it will be skipped.
- `mode` — optional, syntax mode selector.
  Supported values:
    - `legacy` — force the existing legacy path syntax;
    - `jsonpath` — force JSONPath syntax.
  If omitted, the scriptlet detects JSONPath automatically for clearly JSONPath-shaped expressions.

> Note please that you can use wildcard `*` for chain property name,
> e.g. `ad.*.src` instead of `ad.0.src ad.1.src ad.2.src`.

> Usage with only propsToMatch argument will log fetch calls to browser console.
> It may be useful for debugging, but it is not allowed for prod versions of filter lists.

> Scriptlet does nothing if response body can't be converted to JSON.

### Examples

<!-- markdownlint-disable line-length -->

1. Removes property `example` from the JSON response of any fetch call:

    ```adblock
    example.org#%#//scriptlet('json-prune-fetch-response', 'example')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune-fetch-response', '$.example')
    ```

    For instance, if the JSON response of a fetch call is:

    ```js
    {one: 1, example: true}
    ```

    then the response will be modified to:

    ```js
    {one: 1}
    ```

2. A property in a list of properties can be a chain of properties:

    ```adblock
    example.org#%#//scriptlet('json-prune-fetch-response', 'a.b', 'ads.url.first')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune-fetch-response', '[?(@.ads.url.first)]$.a.b')
    ```

3. Removes property `content.ad` from the JSON response of a fetch call if URL contains `content.json`:

    ```adblock
    example.org#%#//scriptlet('json-prune-fetch-response', 'content.ad', '', 'content.json')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune-fetch-response', '$.content.ad', '', 'content.json')
    ```

4. Removes property `content.ad` from the JSON response of a fetch call if its error stack trace contains `test.js`:

    ```adblock
    example.org#%#//scriptlet('json-prune-fetch-response', 'content.ad', '', '', 'test.js')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune-fetch-response', '$.content.ad', '', '', 'test.js')
    ```

5. A property in a list of properties can be a chain of properties with wildcard in it:

    ```adblock
    example.org#%#//scriptlet('json-prune-fetch-response', 'content.*.media.src', 'content.*.media.ad')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune-fetch-response', '$.content.*.media[?(@.ad)].src')
    ```

6. Log all JSON responses of a fetch call:

    ```adblock
    example.org#%#//scriptlet('json-prune-fetch-response')
    ```

<!-- markdownlint-enable line-length -->

[Scriptlet source](../src/scriptlets/json-prune-fetch-response.ts)

* * *

## <a id="json-prune-xhr-response"></a> ⚡️ json-prune-xhr-response

> Added in v1.10.25.

Removes specified properties from the JSON response of a `XMLHttpRequest` call.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/commit/3152896d428c54c76cfd66c3da110bd4d6506cbc

### Syntax

<!-- markdownlint-disable line-length -->

```text
example.org#%#//scriptlet('json-prune-xhr-response'[, propsToRemove[, obligatoryProps[, propsToMatch[, stack[, mode]]]]])
```

<!-- markdownlint-enable line-length -->

- `propsToRemove` — optional, string of space-separated properties to remove.
  In `jsonpath` mode only single JSONPath prune expression is supported.
- `obligatoryProps` — optional, string of space-separated properties
  which must be all present for the pruning to occur.
- `propsToMatch` — optional, string of space-separated properties to match for extra condition; possible props:
    - string or regular expression for matching the URL passed to `XMLHttpRequest.open()` call;
    - colon-separated pairs `name:value` where:
        - `name` — string or regular expression for matching XMLHttpRequest property name;
        - `value` — string or regular expression for matching the value of the option
          passed to `XMLHttpRequest.open()` call.
- `stack` — optional, string or regular expression that must match the current function call stack trace;
  if regular expression is invalid it will be skipped.
- `mode` — optional, syntax mode selector.
  Supported values:
    - `legacy` — force the existing legacy path syntax;
    - `jsonpath` — force JSONPath syntax.
  If omitted, the scriptlet detects JSONPath automatically for clearly JSONPath-shaped expressions.

> Note please that you can use wildcard `*` for chain property name,
> e.g. `ad.*.src` instead of `ad.0.src ad.1.src ad.2.src`.

> Usage with with only propsToMatch argument will log XMLHttpRequest calls to browser console.
> It may be useful for debugging but it is not allowed for prod versions of filter lists.

> Scriptlet does nothing if response body can't be converted to JSON.

### Examples

1. Removes property `example` from the JSON response of any XMLHttpRequest call

    ```adblock
    example.org#%#//scriptlet('json-prune-xhr-response', 'example')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune-xhr-response', '$.example')
    ```

    For instance, if the JSON response of a XMLHttpRequest call is:

    ```js
    {one: 1, example: true}
    ```

    then the response will be modified to:

    ```js
    {one: 1}
    ```

2. A property in a list of properties can be a chain of properties

    ```adblock
    example.org#%#//scriptlet('json-prune-xhr-response', 'a.b', 'ads.url.first')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune-xhr-response', '[?(@.ads.url.first)]$.a.b')
    ```

3. Removes property `content.ad` from the JSON response of a XMLHttpRequest call if URL contains `content.json`

    ```adblock
    example.org#%#//scriptlet('json-prune-xhr-response', 'content.ad', '', 'content.json')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune-xhr-response', '$.content.ad', '', 'content.json')
    ```

4. Removes property `content.ad` from the JSON response of a XMLHttpRequest call
if its error stack trace contains `test.js`

    ```adblock
    example.org#%#//scriptlet('json-prune-xhr-response', 'content.ad', '', '', 'test.js')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune-xhr-response', '$.content.ad', '', '', 'test.js')
    ```

5. A property in a list of properties can be a chain of properties with wildcard in it

    ```adblock
    example.org#%#//scriptlet('json-prune-xhr-response', 'content.*.media.src', 'content.*.media.ad')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune-xhr-response', '$.content.*.media[?(@.ad)].src')
    ```

6. Log all JSON responses of a XMLHttpRequest call

    ```adblock
    example.org#%#//scriptlet('json-prune-xhr-response')
    ```

[Scriptlet source](../src/scriptlets/json-prune-xhr-response.ts)

* * *

## <a id="json-prune"></a> ⚡️ json-prune

> Added in v1.1.0.

Removes specified properties from the result of calling JSON.parse and returns the caller.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#json-prunejs-

Related ABP source:
https://gitlab.com/eyeo/snippets/-/blob/main/source/behavioral/json-prune.js

### Syntax

```text
example.org#%#//scriptlet('json-prune'[, propsToRemove [, obligatoryProps [, stack [, mode]]]])
```

- `propsToRemove` — optional, string of space-separated properties to remove.
  In `jsonpath` mode only single JSONPath prune expression is supported.
- `obligatoryProps` — optional, string of space-separated properties
  which must be all present for the pruning to occur.
  In `jsonpath` mode this argument is ignored. Express such preconditions
  directly in `propsToRemove` with leading JSONPath guards and filters.
- `stack` — optional, string or regular expression that must match the current function call stack trace;
  if regular expression is invalid it will be skipped.
- `mode` — optional, syntax mode selector.
  Supported values:
    - `legacy` — force the existing legacy path syntax;
    - `jsonpath` — force JSONPath syntax.
  If omitted, the scriptlet detects JSONPath automatically only for clearly JSONPath-shaped expressions,
  otherwise it falls back to legacy syntax.

> Note please that you can use wildcard `*` for chain property name,
> e.g. `ad.*.src` instead of `ad.0.src ad.1.src ad.2.src`.

### Examples

1. Removes property `example` from the results of `JSON.parse` call

    ```adblock
    example.org#%#//scriptlet('json-prune', 'example')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune', '$.example')
    ```

    `JSON.parse` call:

    ```html
    JSON.parse('{"one":1,"example":true}')
    ```

    Input JSON:

    ```json
    {
      "one": 1,
      "example": true
    }
    ```

    Output:

    ```json
    {
      "one": 1
    }
    ```

1. If there are no specified properties in the result of `JSON.parse` call, pruning will NOT occur

    ```adblock
    example.org#%#//scriptlet('json-prune', 'one', 'obligatoryProp')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune', '[?(@.obligatoryProp)]$.one')
    ```

    `JSON.parse` call:

    ```html
    JSON.parse('{"one":1,"two":2}')
    ```

    Input JSON:

    ```json
    {
      "one": 1,
      "two": 2
    }
    ```

    Output:

    ```json
    {
      "one": 1,
      "two": 2
    }
    ```

1. A property in a list of properties can be a chain of properties

    ```adblock
    example.org#%#//scriptlet('json-prune', 'a.b', 'ads.url.first')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune', '[?(@.ads.url.first)]$.a.b')
    ```

    `JSON.parse` call:

    ```html
    JSON.parse('{"a":{"b":123},"ads":{"url":{"first":"abc"}}}')
    ```

    Input JSON:

    ```json
    {
      "a": {
        "b": 123
      },
      "ads": {
        "url": {
          "first": "abc"
        }
      }
    }
    ```

    Output:

    ```json
    {
      "a": {},
      "ads": {
        "url": {
          "first": "abc"
        }
      }
    }
    ```

1. Removes property `content.ad` from the results of `JSON.parse` call if its error stack trace contains `test.js`

    ```adblock
    example.org#%#//scriptlet('json-prune', 'content.ad', '', 'test.js')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune', '$.content.ad', '', 'test.js')
    ```

    `JSON.parse` call:

    ```html
    JSON.parse('{"content":{"ad":{"src":"a.js"}}}')
    ```

    Input JSON:

    ```json
    {
      "content": {
        "ad": {
          "src": "a.js"
        }
      }
    }
    ```

    Output:

    ```json
    {
      "content": {}
    }
    ```

1. A property in a list of properties can be a chain of properties with wildcard in it

    ```adblock
    example.org#%#//scriptlet('json-prune', 'content.*.media.src', 'content.*.media.ad')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune', '[?(@.content.*.media.ad)]$.content.*.media.src')
    ```

    `JSON.parse` call:

    ```html
    JSON.parse('{"content":{"block1":{"media":{"src":"1.jpg","ad":true}},"block2":{"media":{"src":"2.jpg"}}}}')
    ```

    Input JSON:

    ```json
    {
      "content": {
        "block1": {
          "media": {
            "src": "1.jpg",
            "ad": true
          }
        },
        "block2": {
          "media": {
            "src": "2.jpg"
          }
        }
      }
    }
    ```

    Output:

    ```json
    {
      "content": {
        "block1": {
          "media": {
            "ad": true
          }
        },
        "block2": {
          "media": {}
        }
      }
    }
    ```

1. Removes every property from `videos` object if it has `isAd` key

    ```adblock
    example.org#%#//scriptlet('json-prune', 'videos.{-}.isAd')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune', '$.videos.*[?(@.isAd)]')
    ```

    `JSON.parse` call:

    ```html
    JSON.parse('{"videos":{"video1":{"isAd":true,"src":"video1.mp4"},"video2":{"src":"video1.mp4"}}}')
    ```

    Input JSON:

    ```json
    {
      "videos": {
        "video1": {
          "isAd": true,
          "src": "video1.mp4"
        },
        "video2": {
          "src": "video1.mp4"
        }
      }
    }
    ```

    Output:

    ```json
    {
      "videos": {
        "video2": {
          "src": "video1.mp4"
        }
      }
    }
    ```

1. Removes every property from `videos` object if it has `isAd` key with `true` value

    ```adblock
    example.org#%#//scriptlet('json-prune', 'videos.{-}.isAd.[=].true')
    ```

    or `JSONPath` syntax:

    ```adblock
    example.org#%#//scriptlet('json-prune', '$.videos.*[?(@.isAd==true)]')
    ```

    `JSON.parse` call:

    ```html
    JSON.parse('{"videos":{"video1":{"isAd":true,"src":"video1.mp4"},"video2":{"isAd":false,"src":"video1.mp4"}}}')
    ```

    Input JSON:

    ```json
    {
      "videos": {
        "video1": {
          "isAd": true,
          "src": "video1.mp4"
        },
        "video2": {
          "isAd": false,
          "src": "video1.mp4"
        }
      }
    }
    ```

    Output:

    ```json
    {
      "videos": {
        "video2": {
          "isAd": false,
          "src": "video1.mp4"
        }
      }
    }
    ```

1. Call with no arguments will log the current hostname and JSON payload at the console

    ```adblock
    example.org#%#//scriptlet('json-prune')
    ```

1. Call with only second argument will log the current hostname and matched json payload at the console

    ```adblock
    example.org#%#//scriptlet('json-prune', '', '"id":"117458"')
    ```

[Scriptlet source](../src/scriptlets/json-prune.js)

* * *

## <a id="log-addeventlistener"></a> ⚡️ log-addEventListener

> Added in v1.0.4.

Logs all addEventListener calls to the console.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#addeventlistener-loggerjs-

### Syntax

```text
example.org#%#//scriptlet('log-addEventListener'[, noProtect])
```

- `noProtect` — optional, if set to `'true'`, the scriptlet will use simple assignment instead of
  `Object.defineProperty` with a no-op setter. This allows other scriptlets or tools to override
  `addEventListener` later if needed. By default, the scriptlet protects the override from being
  overwritten by website scripts. If compatibility with other scriptlets is needed,
  set this parameter to `'true'`.

[Scriptlet source](../src/scriptlets/log-addEventListener.ts)

* * *

## <a id="log-eval"></a> ⚡️ log-eval

> Added in v1.0.4.

Logs all `eval()` or `new Function()` calls to the console.

### Syntax

```adblock
example.org#%#//scriptlet('log-eval')
```

[Scriptlet source](../src/scriptlets/log-eval.js)

* * *

## <a id="log-on-stack-trace"></a> ⚡️ log-on-stack-trace

> Added in v1.5.0.

This scriptlet is basically the same as [abort-on-stack-trace](#abort-on-stack-trace),
but instead of aborting it logs:

- function and source script names pairs that access the given property
- was that get or set attempt
- script being injected or inline

### Syntax

```text
example.com#%#//scriptlet('log-on-stack-trace', property)
```

- `property` — required, path to a property. The property must be attached to window.

### Examples

1. Log stack trace when it tries to access `window.open`

    ```adblock
    example.org#%#//scriptlet('log-on-stack-trace', 'open')
    ```

[Scriptlet source](../src/scriptlets/log-on-stack-trace.js)

* * *

## <a id="log"></a> ⚡️ log

> Added in v1.0.4.

A simple scriptlet which only purpose is to print arguments to console.
This scriptlet can be helpful for debugging and troubleshooting other scriptlets.

Related ABP source:
https://gitlab.com/eyeo/snippets/-/blob/main/source/introspection/log.js

### Examples

```adblock
example.org#%#//scriptlet('log', 'arg1', 'arg2')
```

[Scriptlet source](../src/scriptlets/log.js)

* * *

## <a id="m3u-prune"></a> ⚡️ m3u-prune

> Added in v1.9.1.

Removes content from the specified M3U file.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#m3u-prunejs-

### Syntax

```text
example.org#%#//scriptlet('m3u-prune'[, propsToRemove[, urlToMatch]])
```

- `propsToRemove` — optional, string or regular expression
  to match the URL line (segment) which will be removed alongside with its tags
- `urlToMatch` — optional, string or regular expression for matching the request's URL
- `verbose` — optional, boolean, if set to 'true' will log original and modified M3U content

> `verbose` may be useful for debugging but it is not allowed for prod versions of filter lists.

> Usage with no arguments will log response payload and URL to browser console;
> it may be useful for debugging but it is not allowed for prod versions of filter lists.

### Examples

1. Removes a tag which contains `example.com/video/`, from all requests

    ```adblock
    example.org#%#//scriptlet('m3u-prune', 'example.com/video/')
    ```

1. Removes a line which contains `example.com/video/`, only if request's URL contains `.m3u8`

    ```adblock
    example.org#%#//scriptlet('m3u-prune', 'example.com/video/', '.m3u8')
    ```

1. Removes a line which contains `example.com/video/`, only if request's URL contains `.m3u8` and log content

    ```adblock
    example.org#%#//scriptlet('m3u-prune', 'example.com/video/', '.m3u8', 'true')
    ```

1. Call with no arguments will log response payload and URL at the console

    ```adblock
    example.org#%#//scriptlet('m3u-prune')
    ```

1. Call with only `urlToMatch` argument will log response payload and URL only for the matched URL

    ```adblock
    example.org#%#//scriptlet('m3u-prune', '', '.m3u8')
    ```

[Scriptlet source](../src/scriptlets/m3u-prune.js)

* * *

## <a id="matomo"></a> ⚡️ matomo

> Added in v1.10.25.

Mocks the piwik.js file of Matomo (formerly Piwik).

### Examples

```adblock
example.org#%#//scriptlet('matomo')
```

[Scriptlet source](../src/scriptlets/matomo.ts)

* * *

## <a id="metrika-yandex-tag"></a> ⚡️ metrika-yandex-tag

> Added in v1.10.25.

Mocks Yandex Metrika API.
https://yandex.ru/support/metrica/objects/method-reference.html

### Examples

```adblock
example.org#%#//scriptlet('metrika-yandex-tag')
```

[Scriptlet source](../src/scriptlets/metrika-yandex-tag.ts)

* * *

## <a id="metrika-yandex-watch"></a> ⚡️ metrika-yandex-watch

> Added in v1.10.25.

Mocks the old Yandex Metrika API.
https://yandex.ru/support/metrica/objects/_method-reference.html

### Examples

```adblock
example.org#%#//scriptlet('metrika-yandex-watch')
```

[Scriptlet source](../src/scriptlets/metrika-yandex-watch.ts)

* * *

## <a id="naver-wcslog"></a> ⚡️ naver-wcslog

> Added in v1.10.25.

Mocks wcslog.js of Naver Analytics.

### Examples

```adblock
example.org#%#//scriptlet('naver-wcslog')
```

[Scriptlet source](../src/scriptlets/naver-wcslog.ts)

* * *

## <a id="no-protected-audience"></a> ⚡️ no-protected-audience

> Added in v1.10.25.

Prevents using the Protected Audience API.
https://wicg.github.io/turtledove/

### Syntax

```adblock
example.org#%#//scriptlet('no-protected-audience')
```

[Scriptlet source](../src/scriptlets/no-protected-audience.ts)

* * *

## <a id="no-topics"></a> ⚡️ no-topics

> Added in v1.6.18.

Prevents using the Topics API.
https://developer.chrome.com/docs/privacy-sandbox/topics/

### Syntax

```adblock
example.org#%#//scriptlet('no-topics')
```

[Scriptlet source](../src/scriptlets/no-topics.js)

* * *

## <a id="noeval"></a> ⚡️ noeval

> Added in v1.0.4.

Prevents page to use eval.
Notifies about attempts in the console

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#noevaljs-

It also can be used as `$redirect` rules sometimes.
See [redirect description](../wiki/about-redirects.md#noeval).

### Syntax

```adblock
example.org#%#//scriptlet('noeval')
```

[Scriptlet source](../src/scriptlets/noeval.js)

* * *

## <a id="nowebrtc"></a> ⚡️ nowebrtc

> Added in v1.0.4.

Disables WebRTC by overriding `RTCPeerConnection`.
The overridden function will log every attempt to create a new connection.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#nowebrtcjs-

### Syntax

```adblock
example.org#%#//scriptlet('nowebrtc')
```

[Scriptlet source](../src/scriptlets/nowebrtc.js)

* * *

## <a id="pardot-1.0"></a> ⚡️ pardot-1.0

> Added in v1.10.25.

Mocks the pd.js file of Salesforce.
https://pi.pardot.com/pd.js
https://developer.salesforce.com/docs/marketing/pardot/overview

### Examples

```adblock
example.org#%#//scriptlet('pardot-1.0')
```

[Scriptlet source](../src/scriptlets/pardot-1.0.ts)

* * *

## <a id="prebid"></a> ⚡️ prebid

> Added in v1.10.25.

Mocks the prebid.js header bidding suit.
https://docs.prebid.org/

### Examples

```adblock
example.org#%#//scriptlet('prebid')
```

[Scriptlet source](../src/scriptlets/prebid.ts)

* * *

## <a id="prevent-addeventlistener"></a> ⚡️ prevent-addEventListener

> Added in v1.0.4.

Prevents adding event listeners for the specified events and callbacks.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#addeventlistener-defuserjs-

Related ABP snippet:
https://gitlab.com/eyeo/snippets/-/blob/main/source/behavioral/prevent-listener.js

### Syntax

<!-- markdownlint-disable line-length -->

```text
example.org#%#//scriptlet('prevent-addEventListener'[, typeSearch[, listenerSearch[, additionalArgName, additionalArgValue[, noProtect]]]])
```

<!-- markdownlint-enable line-length -->

- `typeSearch` — optional, string or regular expression matching the type (event name);
  defaults to match all types; invalid regular expression will cause exit and rule will not work
- `listenerSearch` — optional, string or regular expression matching the listener function body;
  defaults to match all listeners; invalid regular expression will cause exit and rule will not work
- `additionalArgName` — optional, string, name of the additional argument to match;
  currently only `elements` is supported;
- `additionalArgValue` — optional, value corresponding to the additional argument name;
  for `elements` it can be a CSS selector or one of the following values:
    - `window`
    - `document`
- `noProtect` — optional, if set to `'true'`, the scriptlet will use simple assignment instead of
  `Object.defineProperty` with a no-op setter. This allows other scriptlets or tools to override
  `addEventListener` later if needed. By default, the scriptlet protects the override from being
  overwritten by website scripts. If compatibility with other scriptlets is needed,
  set this parameter to `'true'`.

### Examples

1. Prevent all `click` listeners

    ```adblock
    example.org#%#//scriptlet('prevent-addEventListener', 'click')
    ```

1. Prevent 'click' listeners with the callback body containing `searchString`

    ```adblock
    example.org#%#//scriptlet('prevent-addEventListener', 'click', 'searchString')
    ```

    For instance, this listener will not be called:

    ```javascript
    el.addEventListener('click', () => {
        window.test = 'searchString';
    });
    ```

1. Prevent 'click' listeners with the callback body containing `foo` and only if the element has the class `bar`

    ```adblock
    example.org#%#//scriptlet('prevent-addEventListener', 'click', 'foo', 'elements', '.bar')
    ```

    For instance, this listener will not be called:

    ```javascript
    const el = document.querySelector('.bar');
    el.addEventListener('click', () => {
        window.test = 'foo';
    });
    ```

    This listener will be called:

    ```javascript
    const el = document.querySelector('.xyz');
    el.addEventListener('click', () => {
        window.test = 'foo';
    });
    ```

1. Prevent 'click' listeners and allow other scriptlets to override `addEventListener`

    ```adblock
    example.org#%#//scriptlet('prevent-addEventListener', 'click', '', '', '', 'true')
    ```

[Scriptlet source](../src/scriptlets/prevent-addEventListener.js)

* * *

## <a id="prevent-adfly"></a> ⚡️ prevent-adfly

> Added in v1.0.4.

Prevents anti-adblock scripts on adfly short links.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#adfly-defuserjs-

### Syntax

```adblock
example.org#%#//scriptlet('prevent-adfly')
```

[Scriptlet source](../src/scriptlets/prevent-adfly.js)

* * *

## <a id="prevent-bab"></a> ⚡️ prevent-bab

> Added in v1.0.4.

Prevents BlockAdblock script from detecting an ad blocker.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#bab-defuserjs-

It also can be used as `$redirect` sometimes.
See [redirect description](../wiki/about-redirects.md#prevent-bab).

### Syntax

```adblock
example.org#%#//scriptlet('prevent-bab')
```

[Scriptlet source](../src/scriptlets/prevent-bab.js)

* * *

## <a id="prevent-canvas"></a> ⚡️ prevent-canvas

> Added in v2.0.1.

Prevents calls to `HTMLCanvasElement.prototype.getContext` and returns `null`.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#prevent-canvasjs-

### Syntax

```text
example.org#%#//scriptlet('prevent-canvas'[, contextType])
```

- `contextType` — optional, string matching the context type (e.g., '2d', 'webgl');
  by default it matches all context types.
  It can be a string pattern or a regular expression pattern.
  If the pattern starts with `!`, it will be negated.

### Examples

1. Prevent all canvas contexts

    ```adblock
    example.org#%#//scriptlet('prevent-canvas')
    ```

1. Prevent only '2d' canvas contexts

    ```adblock
    example.org#%#//scriptlet('prevent-canvas', '2d')
    ```

1. Prevent all canvas contexts except '2d'

    ```adblock
    example.org#%#//scriptlet('prevent-canvas', '!2d')
    ```

[Scriptlet source](../src/scriptlets/prevent-canvas.ts)

* * *

## <a id="prevent-constructor"></a> ⚡️ prevent-constructor

> Added in v2.2.16.

Prevents a constructor call if the constructor name
and optionally the first argument match the specified criteria.
This scriptlet is useful for blocking constructors like `Promise` or `MutationObserver`
that can be used to circumvent existing scriptlets like `prevent-addEventListener`.

### Syntax

```text
example.org#%#//scriptlet('prevent-constructor', constructorName[, argumentSearch])
```

- `constructorName` — required, string, the name of the constructor to prevent,
  e.g., "Promise", "MutationObserver".
  Must be a property of the global `window` object.
- `argumentsMatch` — optional, string or regular expression,
  or JSON array of patterns matching arguments passed to the constructor.
  Defaults to match all constructors if not specified.
  Possible values:
    - string — matches the first argument only;
    - JSON array — matches arguments positionally, should be wrapped in `[]`;
      use `"*"` to skip positions, e.g., if only second argument should be matched.
      Invalid regular expression or JSON will cause exit and rule will not work.

### Examples

1. Prevent all `MutationObserver` constructor calls

    ```adblock
    example.org#%#//scriptlet('prevent-constructor', 'MutationObserver')
    ```

1. Prevent `Promise` constructor calls where the first argument contains `adblock`

    ```adblock
    example.org#%#//scriptlet('prevent-constructor', 'Promise', 'adblock')
    ```

1. Prevent `MutationObserver` calls where the first argument matches a regexp

    ```adblock
    example.org#%#//scriptlet('prevent-constructor', 'MutationObserver', '/detect.*ad/')
    ```

1. Prevent `MutationObserver` calls where the second argument contains `attributes`,
   and matching of the first argument is skipped

    ```adblock
    example.org#%#//scriptlet('prevent-constructor', 'MutationObserver', '["*", "attributes"]')
    ```

[Scriptlet source](../src/scriptlets/prevent-constructor.ts)

* * *

## <a id="prevent-element-src-loading"></a> ⚡️ prevent-element-src-loading

> Added in v1.6.2.

Prevents target element source loading without triggering 'onerror' listeners and not breaking 'onload' ones.

### Syntax

```text
example.org#%#//scriptlet('prevent-element-src-loading', tagName, match)
```

- `tagName` — required, case-insensitive target element tagName
  which `src` property resource loading will be silently prevented; possible values:
    - `script`
    - `img`
    - `iframe`
    - `link`
- `match` — required, string or regular expression for matching the element's URL;

### Examples

1. Prevent script source loading

    ```adblock
    example.org#%#//scriptlet('prevent-element-src-loading', 'script', 'adsbygoogle')
    ```

[Scriptlet source](../src/scriptlets/prevent-element-src-loading.js)

* * *

## <a id="prevent-eval-if"></a> ⚡️ prevent-eval-if

> Added in v1.0.4.

Prevents page to use eval matching payload.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#noeval-ifjs-

### Syntax

```text
example.org#%#//scriptlet('prevent-eval-if'[, search])
```

- `search` — optional, string or regular expression matching the stringified eval payload;
  defaults to match all stringified eval payloads;
  invalid regular expression will cause exit and rule will not work

### Examples

```adblock
! Prevents eval if it matches 'test'
example.org#%#//scriptlet('prevent-eval-if', 'test')
```

[Scriptlet source](../src/scriptlets/prevent-eval-if.js)

* * *

## <a id="prevent-fab-3.2.0"></a> ⚡️ prevent-fab-3.2.0

> Added in v1.0.4.

Prevents execution of the FAB script v3.2.0.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#nofabjs-

### Syntax

```adblock
example.org#%#//scriptlet('prevent-fab-3.2.0')
```

[Scriptlet source](../src/scriptlets/prevent-fab-3.2.0.js)

* * *

## <a id="prevent-fetch"></a> ⚡️ prevent-fetch

> Added in v1.3.18.

Prevents `fetch` calls if **all** given parameters match.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#no-fetch-ifjs-

### Syntax

```text
example.org#%#//scriptlet('prevent-fetch'[, propsToMatch[, responseBody[, responseConfig]]])
```

- `propsToMatch` — optional, string of space-separated properties to match; possible props:
    - string or regular expression for matching the URL passed to fetch call;
      empty string, wildcard `*` or invalid regular expression will match all fetch calls
    - colon-separated pairs `name:value` where
        <!-- markdownlint-disable-next-line line-length -->
        - `name` is [`init` option name](https://developer.mozilla.org/en-US/docs/Web/API/WindowOrWorkerGlobalScope/fetch#parameters)
        - `value` is string or regular expression for matching the value of the option passed to fetch call;
          invalid regular expression will cause any value matching
- `responseBody` — optional, string for defining response body value,
  defaults to `emptyObj`. Possible values:
    - `emptyObj` — empty object
    - `emptyArr` — empty array
    - `emptyStr` — empty string
    - `true` — random alphanumeric string of 10 symbols
    - colon-separated pair `name:value` string value to customize `responseBody` where
        - `name` — only `length` supported for now
        - `value` — single number (e.g. `50`) or range of numbers (e.g. `100-300`), values above 500000 are rejected
- `responseConfig` — optional, string for defining response properties.
  Original response values are used if not specified. Possible values:
    - response type shorthand (for backwards compatibility):
        - `basic`
        - `cors`
        - `error`
        - `opaque`
        - `opaqueredirect`
    - JSON object string with quoted keys and any combination of these properties:
        - `ok` — boolean
        - `redirected` — boolean
        - `status` — non-negative integer from range `0..599`
        - `statusText` — one of `""`, `"OK"`, `"Continue"`, `"Not Found"`
        - `type` — one of the supported response type values above

> Usage with no arguments will log fetch calls to browser console;
> it may be useful for debugging but it is not allowed for prod versions of filter lists.

### Examples

1. Log all fetch calls

    ```adblock
    example.org#%#//scriptlet('prevent-fetch')
    ```

1. Prevent all fetch calls

    ```adblock
    example.org#%#//scriptlet('prevent-fetch', '*')
    ! or
    example.org#%#//scriptlet('prevent-fetch', '')
    ```

1. Prevent fetch call for specific url

    ```adblock
    example.org#%#//scriptlet('prevent-fetch', '/url\\.part/')
    ```

1. Prevent fetch call for specific request method

    ```adblock
    example.org#%#//scriptlet('prevent-fetch', 'method:HEAD')
    ```

1. Prevent fetch call for specific url and request method

    ```adblock
    example.org#%#//scriptlet('prevent-fetch', '/specified_url_part/ method:/HEAD|GET/')
    ```

1. Prevent fetch call and specify response body value

    ```adblock
    ! Specify response body for fetch call to a specific url
    example.org#%#//scriptlet('prevent-fetch', '/specified_url_part/ method:/HEAD|GET/', 'emptyArr')

    ! Specify response body for all fetch calls
    example.org#%#//scriptlet('prevent-fetch', '', 'emptyArr')

    ! Specify response body to random alphanumeric string of 10 symbols for all fetch calls
    example.org#%#//scriptlet('prevent-fetch', '', 'true')

    ! Specify response body to random alphanumeric string with specific range for all fetch calls
    example.org#%#//scriptlet('prevent-fetch', '', 'length:100-300')
    ```

1. Prevent all fetch calls and specify response type value

    ```adblock
    example.org#%#//scriptlet('prevent-fetch', '*', '', 'opaque')
    ```

1. Prevent all fetch calls and specify response properties

    ```adblock
    ! Set multiple response properties at once
    example.org#%#//scriptlet('prevent-fetch', '*', '', '{"status": 404, "statusText": "Not Found", "ok": false}')

    ! Set response type together with other values
    example.org#%#//scriptlet('prevent-fetch', '*', '', '{"type": "opaqueredirect", "redirected": true}')
    ```

[Scriptlet source](../src/scriptlets/prevent-fetch.js)

* * *

## <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-navigation"></a> ⚡️ prevent-navigation

> Added in v2.2.16.

Prevents navigation to URL matching the specified pattern by intercepting the `navigate` event.

### Syntax

```text
example.org#%#//scriptlet('prevent-navigation'[, urlPattern])
```

- `urlPattern` — optional, string, regular expression or `location.href` keyword to match URL.

> Usage with no arguments will log navigation attempts to browser console.

### Examples

1. Prevent navigation to URL containing `ads`:

    ```adblock
    example.org#%#//scriptlet('prevent-navigation', 'ads')
    ```

1. Prevent navigation to URLs matching regex:

    ```adblock
    example.org#%#//scriptlet('prevent-navigation', '/foo.*bar/')
    ```

1. Prevent `location.reload`:

    ```adblock
    example.org#%#//scriptlet('prevent-navigation', 'location.href')
    ```

1. Log all navigation attempts without blocking:

    ```adblock
    example.org#%#//scriptlet('prevent-navigation')
    ```

[Scriptlet source](../src/scriptlets/prevent-navigation.ts)

* * *

## <a id="prevent-popads-net"></a> ⚡️ prevent-popads-net

> Added in v1.0.4.

Aborts on property write (PopAds, popns), throws reference error with random id.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#popadsnetjs-

### Syntax

```adblock
example.org#%#//scriptlet('prevent-popads-net')
```

[Scriptlet source](../src/scriptlets/prevent-popads-net.js)

* * *

## <a id="prevent-refresh"></a> ⚡️ prevent-refresh

> Added in v1.6.2.

Prevents reloading of a document through a meta "refresh" tag.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#refresh-defuserjs-

### Syntax

```text
example.org#%#//scriptlet('prevent-refresh'[, delay])
```

- `delay` — optional, number of seconds for delay that indicates when scriptlet should run.
  If not set, source tag value will be applied.

### Examples

1. Prevent reloading of a document through a meta "refresh" tag

    ```adblock
    example.org#%#//scriptlet('prevent-refresh')
    ```

1. Prevent reloading of a document with delay

    ```adblock
    example.com#%#//scriptlet('prevent-refresh', '3')
    ```

[Scriptlet source](../src/scriptlets/prevent-refresh.js)

* * *

## <a id="prevent-requestanimationframe"></a> ⚡️ prevent-requestAnimationFrame

> Added in v1.1.15.

Prevents a `requestAnimationFrame` call
if the text of the callback is matching the specified search string which does not start with `!`;
otherwise mismatched calls should be defused.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#no-requestanimationframe-ifjs-

### Syntax

```text
example.org#%#//scriptlet('prevent-requestAnimationFrame'[, search])
```

- `search` — optional, string or regular expression;
  invalid regular expression will be skipped and all callbacks will be matched.
  If starts with `!`, scriptlet will not match the stringified callback but all other will be defused.
  If do not start with `!`, the stringified callback will be matched.

> Call with no argument will log all requestAnimationFrame calls,
> it may be useful for debugging but it is not allowed for prod versions of filter lists.

### Examples

1. Prevents `requestAnimationFrame` calls if the callback matches `/\.test/`

    ```adblock
    example.org#%#//scriptlet('prevent-requestAnimationFrame', '/\.test/')
    ```

    For instance, the following call will be prevented:

    ```javascript
    var times = 0;
    requestAnimationFrame(function change() {
        window.test = 'new value';
        if (times < 2) {
            times += 1;
            requestAnimationFrame(change);
        }
    });
    ```

1. Prevents `requestAnimationFrame` calls if **does not match** 'check'

    ```adblock
    example.org#%#//scriptlet('prevent-requestAnimationFrame', '!check')
    ```

    For instance, only the first call will be prevented:

    ```javascript
    var timesFirst = 0;
    requestAnimationFrame(function changeFirst() {
        window.check = 'should not be prevented';
        if (timesFirst < 2) {
            timesFirst += 1;
            requestAnimationFrame(changeFirst);
        }
    });

    var timesSecond = 0;
    requestAnimationFrame(function changeSecond() {
        window.second = 'should be prevented';
        if (timesSecond < 2) {
            timesSecond += 1;
            requestAnimationFrame(changeSecond);
        }
    });
    ```

[Scriptlet source](../src/scriptlets/prevent-requestAnimationFrame.js)

* * *

## <a id="prevent-setinterval"></a> ⚡️ prevent-setInterval

> Added in v1.0.4.

Prevents a `setInterval` call if:

1. The text of the callback is matching the specified `matchCallback` string/regexp which does not start with `!`;
   otherwise mismatched calls should be defused.
1. The delay is matching the specified `matchDelay`; otherwise mismatched calls should be defused.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#no-setinterval-ifjs-

### Syntax

```text
example.org#%#//scriptlet('prevent-setInterval'[, matchCallback[, matchDelay]])
```

> Call with no arguments will log all setInterval calls (`log-setInterval` superseding),
> it may be useful for debugging but it is not allowed for prod versions of filter lists.

- `matchCallback` — optional, string or regular expression;
  invalid regular expression will be skipped and all callbacks will be matched.
  If starts with `!`, scriptlet will not match the stringified callback but all other will be defused.
  If do not start with `!`, the stringified callback will be matched.
  If not set, prevents all `setInterval` calls due to specified `matchDelay`.
- `matchDelay` — optional, must be an integer or a delay range.
  If starts with `!`, scriptlet will not match the delay but all other will be defused.
  If do not start with `!`, the delay passed to the `setInterval` call will be matched.
  Decimal delay values will be rounded down, e.g `10.95` will be matched by `matchDelay` with value `10`.
  Delay ranges are supported in the format `min-max` (matches if `min <= delay <= max`),
  `min-` (matches if `delay >= min`), or `-max` (matches if `delay <= max`).
  Negative delay values behave the same as `0`, so use `-0` to match them.

> If `prevent-setInterval` log looks like `setInterval(undefined, 1000)`,
> it means that no callback was passed to setInterval() and that's not scriptlet issue
> and obviously it can not be matched by `matchCallback`.

### Examples

1. Prevents `setInterval` calls if the callback matches `/\.test/` regardless of the delay

    ```adblock
    example.org#%#//scriptlet('prevent-setInterval', '/\.test/')
    ```

    For instance, the following call will be prevented:

    ```javascript
    setInterval(function () {
        window.test = "value";
    }, 100);
    ```

1. Prevents `setInterval` calls if the callback does not contain `value`

    ```adblock
    example.org#%#//scriptlet('prevent-setInterval', '!value')
    ```

    For instance, only the first of the following calls will be prevented:

    ```javascript
    setInterval(function () {
        window.test = "test -- prevented";
    }, 300);
    setInterval(function () {
        window.test = "value -- executed";
    }, 400);
    setInterval(function () {
        window.value = "test -- executed";
    }, 500);
    ```

1. Prevents `setInterval` calls if the callback contains `value` and the delay is not set to `300`

    ```adblock
    example.org#%#//scriptlet('prevent-setInterval', 'value', '!300')
    ```

    For instance, only the first of the following calls will not be prevented:

    ```javascript
    setInterval(function () {
        window.test = "value 1 -- executed";
    }, 300);
    setInterval(function () {
        window.test = "value 2 -- prevented";
    }, 400);
    setInterval(function () {
        window.test = "value 3 -- prevented";
    }, 500);
    ```

1. Prevents `setInterval` calls if the callback does not contain `value` and the delay is not set to `300`

    ```adblock
    example.org#%#//scriptlet('prevent-setInterval', '!value', '!300')
    ```

    For instance, only the second of the following calls will be prevented:

    ```javascript
    setInterval(function () {
        window.test = "test -- executed";
    }, 300);
    setInterval(function () {
        window.test = "test -- prevented";
    }, 400);
    setInterval(function () {
        window.test = "value -- executed";
    }, 400);
    setInterval(function () {
        window.value = "test -- executed";
    }, 500);
    ```

1. Prevents `setInterval` calls if the callback contains `value` and delay is a decimal number

    ```adblock
    example.org#%#//scriptlet('prevent-setInterval', 'value', '300')
    ```

    For instance, the following calls will be prevented:

    ```javascript
    setInterval(function () {
        window.test = "value";
    }, 300);
    setInterval(function () {
        window.test = "value";
    }, 300 + Math.random());
    ```

1. Prevents `setInterval` calls if the delay is in the `20-50` range

    ```adblock
    example.org#%#//scriptlet('prevent-setInterval', '', '20-50')
    ```

    For instance, only the second of the following calls will be prevented:

    ```javascript
    setInterval(function () {
        window.test = "10 -- executed";
    }, 10);
    setInterval(function () {
        window.test = "30 -- prevented";
    }, 30);
    ```

1. Prevents `setInterval` calls if the delay is at least `30`

    ```adblock
    example.org#%#//scriptlet('prevent-setInterval', '', '30-')
    ```

    For instance, only the second of the following calls will be prevented:

    ```javascript
    setInterval(function () {
        window.test = "10 -- executed";
    }, 10);
    setInterval(function () {
        window.test = "60 -- prevented";
    }, 60);
    ```

1. Prevents `setInterval` calls if the delay is negative

    ```adblock
    example.org#%#//scriptlet('prevent-setInterval', '', '-0')
    ```

    For instance, the following call will be prevented:

    ```javascript
    setInterval(function () {
        window.test = "negative -- prevented";
    }, -10);
    ```

[Scriptlet source](../src/scriptlets/prevent-setInterval.js)

* * *

## <a id="prevent-settimeout"></a> ⚡️ prevent-setTimeout

> Added in v1.0.4.

Prevents a `setTimeout` call if:

1. The text of the callback is matching the specified `matchCallback` string/regexp which does not start with `!`;
   otherwise mismatched calls should be defused.
1. The delay is matching the specified `matchDelay`; otherwise mismatched calls should be defused.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#no-settimeout-ifjs-

### Syntax

```text
example.org#%#//scriptlet('prevent-setTimeout'[, matchCallback[, matchDelay]])
```

> Call with no arguments will log all setTimeout calls (`log-setTimeout` superseding),
> it may be useful for debugging but it is not allowed for prod versions of filter lists.

- `matchCallback` — optional, string or regular expression;
  invalid regular expression will be skipped and all callbacks will be matched.
  If starts with `!`, scriptlet will not match the stringified callback but all other will be defused.
  If do not start with `!`, the stringified callback will be matched.
  If not set, prevents all `setTimeout` calls due to specified `matchDelay`.
- `matchDelay` — optional, must be an integer or a delay range.
  If starts with `!`, scriptlet will not match the delay but all other will be defused.
  If do not start with `!`, the delay passed to the `setTimeout` call will be matched.
  Decimal delay values will be rounded down, e.g `10.95` will be matched by `matchDelay` with value `10`.
  Delay ranges are supported in the format `min-max` (matches if `min <= delay <= max`),
  `min-` (matches if `delay >= min`), or `-max` (matches if `delay <= max`).
  Negative delay values behave the same as `0`, so use `-0` to match them.

> If `prevent-setTimeout` log looks like `setTimeout(undefined, 1000)`,
> it means that no callback was passed to setTimeout() and that's not scriptlet issue
> and obviously it can not be matched by `matchCallback`.

### Examples

1. Prevents `setTimeout` calls if the callback matches `/\.test/` regardless of the delay

    ```adblock
    example.org#%#//scriptlet('prevent-setTimeout', '/\.test/')
    ```

    For instance, the following call will be prevented:

    ```javascript
    setTimeout(function () {
        window.test = "value";
    }, 100);
    ```

1. Prevents `setTimeout` calls if the callback does not contain `value`

    ```adblock
    example.org#%#//scriptlet('prevent-setTimeout', '!value')
    ```

    For instance, only the first of the following calls will be prevented:

    ```javascript
    setTimeout(function () {
        window.test = "test -- prevented";
    }, 300);
    setTimeout(function () {
        window.test = "value -- executed";
    }, 400);
    setTimeout(function () {
        window.value = "test -- executed";
    }, 500);
    ```

1. Prevents `setTimeout` calls if the callback contains `value` and the delay is not set to `300`

    ```adblock
    example.org#%#//scriptlet('prevent-setTimeout', 'value', '!300')
    ```

    For instance, only the first of the following calls will not be prevented:

    ```javascript
    setTimeout(function () {
        window.test = "value 1 -- executed";
    }, 300);
    setTimeout(function () {
        window.test = "value 2 -- prevented";
    }, 400);
    setTimeout(function () {
        window.test = "value 3 -- prevented";
    }, 500);
    ```

1. Prevents `setTimeout` calls if the callback does not contain `value` and the delay is not set to `300`

    ```adblock
    example.org#%#//scriptlet('prevent-setTimeout', '!value', '!300')
    ```

    For instance, only the second of the following calls will be prevented:

    ```javascript
    setTimeout(function () {
        window.test = "test -- executed";
    }, 300);
    setTimeout(function () {
        window.test = "test -- prevented";
    }, 400);
    setTimeout(function () {
        window.test = "value -- executed";
    }, 400);
    setTimeout(function () {
        window.value = "test -- executed";
    }, 500);
    ```

1. Prevents `setTimeout` calls if the callback contains `value` and delay is a decimal

    ```adblock
    example.org#%#//scriptlet('prevent-setTimeout', 'value', '300')
    ```

    For instance, the following calls will be prevented:

    ```javascript
    setTimeout(function () {
        window.test = "value";
    }, 300);
    setTimeout(function () {
        window.test = "value";
    }, 300 + Math.random());
    ```

1. Prevents `setTimeout` calls if the delay is in the `20-50` range

    ```adblock
    example.org#%#//scriptlet('prevent-setTimeout', '', '20-50')
    ```

    For instance, only the second of the following calls will be prevented:

    ```javascript
    setTimeout(function () {
        window.test = "10 -- executed";
    }, 10);
    setTimeout(function () {
        window.test = "30 -- prevented";
    }, 30);
    ```

1. Prevents `setTimeout` calls if the delay is at least `30`

    ```adblock
    example.org#%#//scriptlet('prevent-setTimeout', '', '30-')
    ```

    For instance, only the second of the following calls will be prevented:

    ```javascript
    setTimeout(function () {
        window.test = "10 -- executed";
    }, 10);
    setTimeout(function () {
        window.test = "60 -- prevented";
    }, 60);
    ```

1. Prevents `setTimeout` calls if the delay is negative

    ```adblock
    example.org#%#//scriptlet('prevent-setTimeout', '', '-0')
    ```

    For instance, the following call will be prevented:

    ```javascript
    setTimeout(function () {
        window.test = "negative -- prevented";
    }, -10);
    ```

[Scriptlet source](../src/scriptlets/prevent-setTimeout.js)

* * *

## <a id="prevent-window-open"></a> ⚡️ prevent-window-open

> Added in v1.0.4.

Prevents `window.open` calls when URL or any other parameter either matches or not matches the specified string/regexp.
Using it without parameters prevents all `window.open` calls.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#no-window-open-ifjs-

### Syntax

```text
example.org#%#//scriptlet('prevent-window-open'[, match[, delay[, replacement]]])
```

- `match` — optional, string or regular expression.
  If not set or regular expression is invalid, all window.open calls will be matched.
  If starts with `!`, scriptlet will not match the stringified callback but all other will be defused.
  If do not start with `!`, the stringified callback will be matched.
- `delay` — optional, number of seconds. If not set, scriptlet will return `null`,
  otherwise valid sham window object as injected `iframe` will be returned
  for accessing its methods (blur(), focus() etc.) and will be removed after the delay.
- `replacement` — optional, string; one of the predefined constants:
    - `obj` — for returning an object instead of default iframe;
       for cases when the page requires a valid `window` instance to be returned
    - `log` — for logging window.open calls; not allowed for prod versions of filter lists.

### Examples

1. Prevent all `window.open` calls

    ```adblock
    example.org#%#//scriptlet('prevent-window-open')
    ```

1. Prevent `window.open` for all URLs containing `example`

    ```adblock
    example.org#%#//scriptlet('prevent-window-open', 'example')
    ```

1. Prevent `window.open` for all URLs matching RegExp `/example\./`

    ```adblock
    example.org#%#//scriptlet('prevent-window-open', '/example\./')
    ```

1. Prevent `window.open` for all URLs **NOT** containing `example`

    ```adblock
    example.org#%#//scriptlet('prevent-window-open', '!example')
    ```

### Old syntax of prevent-window-open parameters

- `match` — optional, defaults to "matching", any positive number or nothing for "matching",
  0 or empty string for "not matching"
- `search` — optional, string or regexp for matching the URL passed to `window.open` call;
  defaults to search all `window.open` call
- `replacement` — optional, string to return prop value or property instead of window.open;
  defaults to return noopFunc.

### Examples of old syntax

```adblock
example.org#%#//scriptlet('prevent-window-open', '1', '/example\./')
example.org#%#//scriptlet('prevent-window-open', '0', 'example')
example.org#%#//scriptlet('prevent-window-open', '', '', 'trueFunc')
example.org#%#//scriptlet('prevent-window-open', '1', '', '{propName=noopFunc}')
```

> For better compatibility with uBO, old syntax is not recommended to use.

[Scriptlet source](../src/scriptlets/prevent-window-open.js)

* * *

## <a id="prevent-xhr"></a> ⚡️ prevent-xhr

> Added in v1.5.0.

Prevents `xhr` calls if **all** given parameters match.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#no-xhr-ifjs-

### Syntax

```text
example.org#%#//scriptlet('prevent-xhr'[, propsToMatch[, directive]])
```

- `propsToMatch` — optional, string of space-separated properties to match; possible props:
    - string or regular expression for matching the URL passed to `XMLHttpRequest.open()` call;
      empty string or wildcard `*` for all `XMLHttpRequest.open()` calls match
        - colon-separated pairs `name:value` where
            - `name` is XMLHttpRequest object property name
            - `value` is string or regular expression for matching the value of the option
    passed to `XMLHttpRequest.open()` call
- `directive` — defaults to `false` for empty responseText,
  optional argument to set responseText and response of matched XMLHttpRequest's response; possible values:
    - `true` to randomize responseText and response, random alphanumeric string of 10 symbols
    - `emptyObj` to set responseText and response to `{}`
    - `emptyArr` to set responseText and response to `[]`
    - `emptyStr` to set responseText and response to an empty string
    - colon-separated pair `name:value` string value to customize responseText and response data where
        - `name` — only `length` supported for now
        - `value` — single number (e.g. `50`) or range of numbers (e.g. `100-300`), values above 500000 are rejected

> Non-keyword values (e.g. literal text) are NOT passed through in the untrusted `prevent-xhr`
> scriptlet — they yield an empty string. Use `trusted-prevent-xhr` for literal-text passthrough.

> Usage with no arguments will log XMLHttpRequest objects to browser console;
> it may be useful for debugging but it is not allowed for prod versions of filter lists.

### Examples

1. Log all XMLHttpRequests

    ```adblock
    example.org#%#//scriptlet('prevent-xhr')
    ```

1. Prevent all XMLHttpRequests

    ```adblock
    example.org#%#//scriptlet('prevent-xhr', '*')
    example.org#%#//scriptlet('prevent-xhr', '')
    ```

1. Prevent XMLHttpRequests for specific url

    ```adblock
    example.org#%#//scriptlet('prevent-xhr', 'example.org')
    ```

1. Prevent XMLHttpRequests for specific request method

    ```adblock
    example.org#%#//scriptlet('prevent-xhr', 'method:HEAD')
    ```

1. Prevent XMLHttpRequests for specific url and specified request methods

    ```adblock
    example.org#%#//scriptlet('prevent-xhr', 'example.org method:/HEAD|GET/')
    ```

1. Prevent XMLHttpRequests for specific url and randomize it's response text

    ```adblock
    example.org#%#//scriptlet('prevent-xhr', 'example.org', 'true')
    ```

1. Prevent XMLHttpRequests for specific url and randomize it's response text with range

    ```adblock
   example.org#%#//scriptlet('prevent-xhr', 'example.org', 'length:100-300')
    ```

1. Prevent XMLHttpRequests for specific url and set response to empty object

    ```adblock
    example.org#%#//scriptlet('prevent-xhr', 'example.org', 'emptyObj')
    ```

[Scriptlet source](../src/scriptlets/prevent-xhr.ts)

* * *

## <a id="remove-attr"></a> ⚡️ remove-attr

> Added in v1.0.4.

Removes the specified attributes from DOM nodes. This scriptlet runs once when the page loads
and after that periodically in order to DOM tree changes by default,
or as specified by applying argument.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#remove-attrjs-

### Syntax

```text
example.org#%#//scriptlet('remove-attr', attrs[, selector, applying])
```

- `attrs` — required, attribute or list of attributes joined by '|'
- `selector` — optional, CSS selector, specifies DOM nodes from which the attributes will be removed
- `applying` — optional, one or more space-separated flags that describe the way scriptlet apply,
  defaults to 'asap stay'; possible flags:
    - `asap` — runs as fast as possible **once**
    - `complete` — runs **once** after the whole page has been loaded
    - `stay` — as fast as possible **and** stays on the page observing possible DOM changes

### Examples

1. Removes by attribute

    ```adblock
    example.org#%#//scriptlet('remove-attr', 'example|test')
    ```

    ```html
    <!-- before -->
    <div example="true" test="true">Some text</div>

    <!-- after -->
    <div>Some text</div>
    ```

1. Removes with specified selector

    ```adblock
    example.org#%#//scriptlet('remove-attr', 'example', 'div[class="inner"]')
    ```

    ```html
    <!-- before -->
    <div class="wrapper" example="true">
        <div class="inner" example="true">Some text</div>
    </div>

    <!-- after -->
    <div class="wrapper" example="true">
        <div class="inner">Some text</div>
    </div>
    ```

1. Using flags

    ```adblock
    example.org#%#//scriptlet('remove-attr', 'example', 'html', 'asap complete')
    ```

[Scriptlet source](../src/scriptlets/remove-attr.js)

* * *

## <a id="remove-class"></a> ⚡️ remove-class

> Added in v1.1.1.

Removes the specified classes from DOM nodes. This scriptlet runs once after the page loads
and after that periodically in order to DOM tree changes.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#remove-classjs-

### Syntax

```text
example.org#%#//scriptlet('remove-class', classes[, selector, applying])
```

- `classes` — required, class or list of classes separated by '|'
- `selector` — optional, CSS selector, specifies DOM nodes from which the classes will be removed.
  If there is no `selector`, each class of `classes` independently will be removed from all nodes which has one
- `applying` — optional, one or more space-separated flags that describe the way scriptlet apply,
  defaults to 'asap stay'; possible flags:
    - `asap` — runs as fast as possible **once**
    - `complete` — runs **once** after the whole page has been loaded
    - `stay` — as fast as possible **and** stays on the page observing possible DOM changes

### Examples

1. Removes by classes

    ```adblock
    example.org#%#//scriptlet('remove-class', 'example|test')
    ```

    ```html
    <!-- before -->
    <div id="first" class="nice test">Some text</div>
    <div id="second" class="rare example for test">Some text</div>
    <div id="third" class="testing better example">Some text</div>

    <!-- after -->
    <div id="first" class="nice">Some text</div>
    <div id="second" class="rare for">Some text</div>
    <div id="third" class="testing better">Some text</div>
    ```

1. Removes with specified selector

    ```adblock
    example.org#%#//scriptlet('remove-class', 'branding', 'div[class^="inner"]')
    ```

    ```html
    <!-- before -->
    <div class="wrapper true branding">
        <div class="inner bad branding">Some text</div>
    </div>

    <!-- after -->
    <div class="wrapper true branding">
        <div class="inner bad">Some text</div>
    </div>
    ```

1. Using flags

    ```adblock
    example.org#%#//scriptlet('remove-class', 'branding', 'div[class^="inner"]', 'asap complete')
    ```

[Scriptlet source](../src/scriptlets/remove-class.js)

* * *

## <a id="remove-cookie"></a> ⚡️ remove-cookie

> Added in v1.0.4.

Removes current page cookies by passed string matching with name. For current domain and subdomains.
Runs on load and before unload.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#cookie-removerjs-

Related ABP source:
https://gitlab.com/eyeo/snippets/-/blob/main/source/behavioral/cookie-remover.js

### Syntax

```text
example.org#%#//scriptlet('remove-cookie'[, match])
```

- `match` — optional, string or regex matching the cookie name.
  If not specified all accessible cookies will be removed.

### Examples

1. Removes all cookies

    ```adblock
    example.org#%#//scriptlet('remove-cookie')
    ```

1. Removes cookies which name contains `example` string

    ```adblock
    example.org#%#//scriptlet('remove-cookie', 'example')
    ```

    For instance this cookie will be removed:

    ```javascript
    document.cookie = '__example=randomValue';
    ```

[Scriptlet source](../src/scriptlets/remove-cookie.js)

* * *

## <a id="remove-in-shadow-dom"></a> ⚡️ remove-in-shadow-dom

> Added in v1.3.14.

Removes elements inside open shadow DOM elements.

### Syntax

```text
example.org#%#//scriptlet('remove-in-shadow-dom', selector[, baseSelector])
```

- `selector` — required, CSS selector of element in shadow-dom to remove
- `baseSelector` — optional, selector of specific page DOM element,
narrows down the part of the page DOM where shadow-dom host supposed to be,
defaults to document.documentElement

> `baseSelector` should match element of the page DOM, but not of shadow DOM.

### Examples

```adblock
! removes menu bar
virustotal.com#%#//scriptlet('remove-in-shadow-dom', 'iron-pages', 'vt-virustotal-app')

! removes floating element
virustotal.com#%#//scriptlet('remove-in-shadow-dom', 'vt-ui-contact-fab')
```

[Scriptlet source](../src/scriptlets/remove-in-shadow-dom.js)

* * *

## <a id="remove-node-text"></a> ⚡️ remove-node-text

> Added in v1.9.37.

Removes text from DOM nodes.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/commit/2bb446797a12086f2eebc0c8635b671b8b90c477

### Syntax

```text
example.org#%#//scriptlet('remove-node-text', nodeName, textMatch[, parentSelector])
```

- `nodeName` — required, string or RegExp, specifies DOM node name from which the text will be removed.
Must target lowercased node names, e.g `div` instead of `DIV`.
- `textMatch` — required, string or RegExp to match against node's text content.
If matched, the whole text will be removed. Case sensitive.
- `parentSelector` — optional, string, CSS selector to match parent node.

### Examples

1. Remove node's text content:

    ```adblock
    example.org#%#//scriptlet('remove-node-text', 'div', 'some text')
    ```

    ```html
    <!-- before -->
    <div>some text</div>
    <span>some text</span>

    <!-- after -->
    <div></div   >
    <span>some text</span>
    ```

2. Remove node's text content, matching both node name and condition by RegExp:

    ```adblock
    example.org#%#//scriptlet('remove-node-text', '/[a-z]*[0-9]/', '/text/')
    ```

    ```html
    <!-- before -->
    <qrce3>some text</qrce3>
    <span>some text</span>

    <!-- after -->
    <qrce3></qrce3>
    <span>some text</span>
    ```

3. Remove node's text content, matching parent node:

    ```adblock
    example.org#%#//scriptlet('remove-node-text', '#text', 'some text', '.container')
    ```

    ```html
    <!-- before -->
    <div class="container">
         some text
     </div>
    <div class="section">
         some text
     </div>
    <!-- after -->
    <div class="container">
    </div>
    <div class="section">
         some text
     </div>
    ```

[Scriptlet source](../src/scriptlets/remove-node-text.js)

* * *

## <a id="remove-request-query-parameter"></a> ⚡️ remove-request-query-parameter

> Added in v2.2.16.

Removes a specified query parameter from matched outgoing requests.

Related ABP source:
https://gitlab.com/eyeo/anti-cv/snippets/-/blob/92f9b84bd0d34dbd0e3c1bfe3ff2062863c7714a/source/behavioral/strip-fetch-query-parameter.js

### Syntax

```text
example.org#%#//scriptlet('remove-request-query-parameter', parametersToRemove[, urlPattern])
```

- `parametersToRemove` — required, either a single regular expression (starting with `/`)
  or a list of literal query parameter names separated by `,`.
  Mixing regular expressions and literal strings is not allowed.
- `urlPattern` — optional, a string or regular expression to match request URLs.

### Examples

1. Remove a specific query parameter from all requests:

    ```adblock
    example.org#%#//scriptlet('remove-request-query-parameter', 'utm_source')
    ```

1. Remove multiple query parameters from all requests:

    ```adblock
    example.org#%#//scriptlet('remove-request-query-parameter', 'utm_source,utm_medium,utm_campaign')
    ```

1. Remove a specific query parameter from requests matching a URL pattern:

    ```adblock
    example.org#%#//scriptlet('remove-request-query-parameter', 'ad_config_id', '/playback/')
    ```

1. Remove query parameters matching a regular expression:

    ```adblock
    example.org#%#//scriptlet('remove-request-query-parameter', '/^utm_/', '/api/')
    ```

[Scriptlet source](../src/scriptlets/remove-request-query-parameter.ts)

* * *

## <a id="scorecardresearch-beacon"></a> ⚡️ scorecardresearch-beacon

> Added in v1.10.25.


### Examples

```adblock
example.org#%#//scriptlet('scorecardresearch-beacon')
```

[Scriptlet source](../src/scriptlets/scorecardresearch-beacon.ts)

* * *

## <a id="set-attr"></a> ⚡️ set-attr

> Added in v1.5.0.

Sets attribute with permitted value on the specified elements. This scriptlet runs once when the page loads
and after that on DOM tree changes.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#set-attrjs-

### Syntax

```text
example.org#%#//scriptlet('set-attr', selector, attr[, value])
```

- `selector` — required, CSS selector, specifies DOM nodes to set attributes on
- `attr` — required, attribute to be set
- `value` — optional, the value to assign to the attribute, defaults to ''. Possible values:
    - `''` — empty string
    - positive decimal integer `<= 32767`
    - `true` / `false` in any case variation
    - `[attribute-name]` copy the value from attribute `attribute-name` on the same element.

### Examples

1. Set attribute by selector

    ```adblock
    example.org#%#//scriptlet('set-attr', 'div > a.class', 'test-attribute', '0')
    ```

    ```html
    <!-- before -->
    <div>
        <a>Another text</a>
        <a class="class">Some text</a>
    </div>

    <!-- after -->
    <div>
        <a>Another text</a>
        <a class="class" test-attribute="0">Some text</a>
    </div>
    ```

1. Set attribute without value

    ```adblock
    example.org#%#//scriptlet('set-attr', 'a.class', 'test-attribute')
    ```

    ```html
    <!-- before -->
    <a class="class">Some text</div>

    <!-- after -->
    <a class="class" test-attribute>Some text</div>
    ```

1. Set attribute value to `TRUE`

    ```adblock
    example.org#%#//scriptlet('set-attr', 'a.class', 'test-attribute', 'TRUE')
    ```

    ```html
    <!-- before -->
    <a class="class">Some text</div>

    <!-- after -->
    <a class="class" test-attribute="TRUE">Some text</div>
    ```

1. Set attribute value to `fAlse`

    ```adblock
    example.org#%#//scriptlet('set-attr', 'a.class', 'test-attribute', 'fAlse')
    ```

    ```html
    <!-- before -->
    <a class="class">Some text</div>

    <!-- after -->
    <a class="class" test-attribute="fAlse">Some text</div>
    ```

1. Copy attribute value from the target element

    ```adblock
    example.org#%#//scriptlet('set-attr', 'iframe[data-cur]', 'href', '[data-cur]')
    ```

    ```html
    <!-- before -->
    <iframe data-cur="good-url.com" href="bad-url.org"></iframe>

    <!-- after -->
    <iframe data-cur="good-url.com" href="good-url.com"></iframe>
    ```

[Scriptlet source](../src/scriptlets/set-attr.js)

* * *

## <a id="set-constant"></a> ⚡️ set-constant

> Added in v1.0.4.

Creates a constant property and assigns it one of the values from the predefined list.

> Actually, it's not a constant. Please note, that it can be rewritten with a value of a different type.

> If empty object is present in chain it will be trapped until chain leftovers appear.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#set-constantjs-

Related ABP snippet:
https://github.com/adblockplus/adblockpluscore/blob/adblockpluschrome-3.9.4/lib/content/snippets.js#L1361

### Syntax

```text
example.org#%#//scriptlet('set-constant', property, value[, stack,[ valueWrapper[, setProxyTrap]]])
```

- `property` — required, path to a property (joined with `.` if needed). The property must be attached to `window`.
- `value` — required. Possible values:
    - positive decimal integer `<= 32767`
    - one of the predefined constants:
        - `undefined`
        - `false`
        - `true`
        - `null`
        - `emptyObj` — empty object
        - `emptyArr` — empty array
        - `noopFunc` — function with empty body
        - `noopCallbackFunc` — function returning noopFunc
        - `trueFunc` — function returning true
        - `falseFunc` — function returning false
        - `throwFunc` — function throwing an error
        - `noopPromiseResolve` — function returning Promise object that is resolved with an empty response
        - `noopPromiseReject` — function returning Promise.reject()
        - `''` — empty string
        - `-1` — number value `-1`
        - `yes`
        - `no`
- `stack` — string or regular expression that must match the current function call stack trace,
  defaults to matching every call; if regular expression is invalid, it will be skipped
- `valueWrapper` – optional, string to modify a value to be set. Possible wrappers:
    - `asFunction` – function returning value
    - `asCallback` – function returning callback, that would return value
    - `asResolved` – Promise that would resolve with value
    - `asRejected` – Promise that would reject with value
- `setProxyTrap` – optional, boolean, if set to true, proxy trap will be set on the object

### Examples

```adblock
! Any access to `window.first` will return `false`
example.org#%#//scriptlet('set-constant', 'first', 'false')

✔ window.first === false
```

```adblock
! Any call to `window.second()` will return `true`
example.org#%#//scriptlet('set-constant', 'second', 'trueFunc')

✔ window.second() === true
✔ window.second.toString() === "function trueFunc() {return true;}"
```

```adblock
! Any call to `document.third()` will return `true` if the method is related to `checking.js`
example.org#%#//scriptlet('set-constant', 'document.third', 'trueFunc', 'checking.js')

✔ document.third() === true  // if the condition described above is met
```

```adblock
! Any call to `document.fourth()` will return `yes`
example.org#%#//scriptlet('set-constant', 'document.fourth', 'yes', '', 'asFunction')

✔ document.fourth() === 'yes'
```

```adblock
! Any call to `document.fifth()` will return `yes`
example.org#%#//scriptlet('set-constant', 'document.fifth', '42', '', 'asRejected')

✔ document.fifth.catch((reason) => reason === 42) // promise rejects with specified number
```

```adblock
! Any access to `window.foo.bar` will return `false` and the proxy trap will be set on the `foo` object
! It may be required in the case when `foo` object is overwritten by website script
! Related to this issue - https://github.com/AdguardTeam/Scriptlets/issues/330
example.org#%#//scriptlet('set-constant', 'foo.bar', 'false', '', '', 'true')

✔ window.foo.bar === false
```

[Scriptlet source](../src/scriptlets/set-constant.js)

* * *

## <a id="set-cookie-reload"></a> ⚡️ set-cookie-reload

> Added in v1.3.14.

Sets a cookie with the specified name and value, path, and domain,
and reloads the current page after the cookie setting.
If reloading option is not needed, use [set-cookie](#set-cookie) scriptlet.

### Syntax

```text
example.org#%#//scriptlet('set-cookie-reload', name, value[, path[, domain]])
```

- `name` — required, cookie name to be set
- `value` — required, cookie value; possible values:
    - positive decimal integer `<= 32767`
    - one of the predefined constants in any case variation:
        - `true` / `t`
        - `false` / `f`
        - `yes` / `y`
        - `no` / `n`
        - `ok`
        - `on` / `off`
        - `all`
        - `accept`/ `accepted` / `notaccepted`
        - `reject` / `rejected`
        - `allow` / `allowed`
        - `declined`
        - `disallow` / `deny` / `denied`
        - `enable` / `enabled`
        - `disable` / `disabled`
        - `mandatory`
        - `necessary` / `required`
        - `hide` / `hidden`
        - `essential` / `nonessential`
        - `checked` / `unchecked`
        - `forbidden` / `forever`
        - `emptyArr` to set an empty array `[]`
        - `emptyObj` to set an empty object `{}`
- `path` — optional, cookie path, defaults to `/`; possible values:
    - `/` — root path
    - `none` — to set no path at all
- `domain` — optional, cookie domain, if not set origin will be set as domain,
             if the domain does not match the origin, the cookie will not be set

> Note that the scriptlet does not encode a cookie name,
> e.g. name 'a:b' will be set as 'a:b' and not as 'a%3Ab'.
>
> Also if a cookie name includes `;`, the cookie will not be set since this may cause the cookie to break.

### Examples

```adblock
example.org#%#//scriptlet('set-cookie-reload', 'checking', 'ok')

example.org#%#//scriptlet('set-cookie-reload', 'gdpr-settings-cookie', '1')

example.org#%#//scriptlet('set-cookie-reload', 'cookie-set', 'true', 'none')

example.org#%#//scriptlet('set-cookie-reload', 'test', '1', 'none', 'example.org')
```

[Scriptlet source](../src/scriptlets/set-cookie-reload.js)

* * *

## <a id="set-cookie"></a> ⚡️ set-cookie

> Added in v1.2.3.

Sets a cookie with the specified name, value, path, and domain.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#set-cookiejs-

### Syntax

```text
example.org#%#//scriptlet('set-cookie', name, value[, path[, domain]])
```

- `name` — required, cookie name to be set
- `value` — required, cookie value; possible values:
    - positive decimal integer `<= 32767`
    - one of the predefined constants in any case variation:
        - `true` / `t`
        - `false` / `f`
        - `yes` / `y`
        - `no` / `n`
        - `ok`
        - `on` / `off`
        - `all`
        - `accept`/ `accepted` / `notaccepted`
        - `reject` / `rejected`
        - `allow` / `allowed`
        - `declined`
        - `disallow` / `deny` / `denied`
        - `enable` / `enabled`
        - `disable` / `disabled`
        - `mandatory`
        - `necessary` / `required`
        - `hide` / `hidden`
        - `essential` / `nonessential`
        - `checked` / `unchecked`
        - `forbidden` / `forever`
        - `emptyArr` to set an empty array `[]`
        - `emptyObj` to set an empty object `{}`
- `path` — optional, cookie path, defaults to `/`; possible values:
    - `/` — root path
    - `none` — to set no path at all
- `domain` — optional, cookie domain, if not set origin will be set as domain,
             if the domain does not match the origin, the cookie will not be set

> Note that the scriptlet does not encode a cookie name,
> e.g. name 'a:b' will be set as 'a:b' and not as 'a%3Ab'.
>
> Also if a cookie name includes `;`, the cookie will not be set since this may cause the cookie to break.

### Examples

```adblock
example.org#%#//scriptlet('set-cookie', 'CookieConsent', '1')

example.org#%#//scriptlet('set-cookie', 'gdpr-settings-cookie', 'true')

example.org#%#//scriptlet('set-cookie', 'cookie_consent', 'ok', 'none')

example.org#%#//scriptlet('set-cookie-reload', 'test', '1', 'none', 'example.org')
```

[Scriptlet source](../src/scriptlets/set-cookie.js)

* * *

## <a id="set-local-storage-item"></a> ⚡️ set-local-storage-item

> Added in v1.4.3.

Adds specified key and its value to localStorage object, or updates the value of the key if it already exists.
Scriptlet won't set item if storage is full.

To remove item from localStorage use `$remove$` as a value.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#set-local-storage-itemjs-

### Syntax

```text
example.com#%#//scriptlet('set-local-storage-item', 'key', 'value')
```

- `key` — required, key name to be set. Should be a string for setting,
  but it also can be a regular expression for removing items from localStorage.
- `value` — required, key value; possible values:
    - positive decimal integer `<= 32767`
    - one of the predefined constants in any case variation:
        - `undefined`
        - `false`
        - `true`
        - `null`
        - `emptyObj` — empty object
        - `emptyArr` — empty array
        - `''` — empty string
        - `yes`
        - `no`
        - `on`
        - `off`
        - `accept`
        - `accepted`
        - `reject`
        - `rejected`
        - `allowed`
        - `denied`
        - `$remove$` — remove specific item from localStorage
        - `forbidden`
        - `forever`

### Examples

```adblock
example.org#%#//scriptlet('set-local-storage-item', 'player.live.current.mute', 'false')

example.org#%#//scriptlet('set-local-storage-item', 'exit-intent-marketing', '1')

! Removes the item with key 'foo' from local storage
example.org#%#//scriptlet('set-local-storage-item', 'foo', '$remove$')

! Removes from local storage all items whose key matches the regular expression `/mp_.*_mixpanel/`
example.org#%#//scriptlet('set-local-storage-item', '/mp_.*_mixpanel/', '$remove$')
```

[Scriptlet source](../src/scriptlets/set-local-storage-item.js)

* * *

## <a id="set-popads-dummy"></a> ⚡️ set-popads-dummy

> Added in v1.0.4.

Sets static properties PopAds and popns.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#popads-dummyjs-

### Syntax

```adblock
example.org#%#//scriptlet('set-popads-dummy')
```

[Scriptlet source](../src/scriptlets/set-popads-dummy.js)

* * *

## <a id="set-session-storage-item"></a> ⚡️ set-session-storage-item

> Added in v1.4.3.

Adds specified key and its value to sessionStorage object, or updates the value of the key if it already exists.
Scriptlet won't set item if storage is full.

To remove item from sessionStorage use `$remove$` as a value.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#set-session-storage-itemjs-

### Syntax

```text
example.com#%#//scriptlet('set-session-storage-item', 'key', 'value')
```

- `key` — required, key name to be set. Should be a string for setting,
  but it also can be a regular expression for removing items from localStorage.
- `value` — required, key value; possible values:
    - positive decimal integer `<= 32767`
    - one of the predefined constants in any case variation:
        - `undefined`
        - `false`
        - `true`
        - `null`
        - `emptyObj` — empty object
        - `emptyArr` — empty array
        - `''` — empty string
        - `yes`
        - `no`
        - `on`
        - `off`
        - `accept`
        - `accepted`
        - `reject`
        - `rejected`
        - `allowed`
        - `denied`
        - `$remove$` — remove specific item from sessionStorage
        - `forbidden`
        - `forever`

### Examples

```adblock
example.org#%#//scriptlet('set-session-storage-item', 'player.live.current.mute', 'false')

example.org#%#//scriptlet('set-session-storage-item', 'exit-intent-marketing', '1')

! Removes the item with key 'foo' from session storage
example.org#%#//scriptlet('set-session-storage-item', 'foo', '$remove$')

! Removes from session storage all items whose key matches the regular expression `/mp_.*_mixpanel/`
example.org#%#//scriptlet('set-session-storage-item', '/mp_.*_mixpanel/', '$remove$')
```

[Scriptlet source](../src/scriptlets/set-session-storage-item.js)

* * *

## <a id="spoof-css"></a> ⚡️ spoof-css

> Added in v1.10.1.

Spoof CSS property value when `getComputedStyle()` or `getBoundingClientRect()` methods is called.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#spoof-cssjs-

### Syntax

```text
example.org#%#//scriptlet('spoof-css', selectors, cssPropertyName, cssPropertyValue)
```

- `selectors` — string of comma-separated selectors to match
- `cssPropertyName` — CSS property name
- `cssPropertyValue` — CSS property value

> Call with `debug` as `cssPropertyName` and `truthy` value as `cssPropertyValue` will trigger debugger statement
> when `getComputedStyle()` or `getBoundingClientRect()` methods is called.
> It may be useful for debugging but it is not allowed for prod versions of filter lists.

### Examples

1. Spoof CSS property value `display` to `block` for all elements with class `adsbygoogle`:

    ```adblock
    example.org#%#//scriptlet('spoof-css', '.adsbygoogle', 'display', 'block')
    ```

2. Spoof CSS property value `height` to `100` for all elements with class `adsbygoogle` and `advert`:

    ```adblock
    example.org#%#//scriptlet('spoof-css', '.adsbygoogle, .advert', 'height', '100')
    ```

3. To invoke debugger statement:

    ```adblock
    example.org#%#//scriptlet('spoof-css', '.adsbygoogle', 'debug', 'true')
    ```

[Scriptlet source](../src/scriptlets/spoof-css.js)

* * *

## <a id="xml-prune"></a> ⚡️ xml-prune

> Added in v1.7.3.

Removes an element from the specified XML.

Related UBO scriptlet:
https://github.com/gorhill/uBlock/wiki/Resources-Library#xml-prunejs-

### Syntax

```text
example.org#%#//scriptlet('xml-prune'[, propsToMatch[, optionalProp[, urlToMatch]]])
```

- `propsToMatch` — optional, XPath or selector of elements which will be removed from XML
- `optionalProp` — optional, selector of elements that must occur in XML document
- `urlToMatch` — optional, string or regular expression for matching the request's URL
- `verbose` — optional, boolean, if set to 'true' will log original and modified XML content

> `verbose` may be useful for debugging but it is not allowed for prod versions of filter lists.

> Usage with no arguments will log response payload and URL to browser console;
> it may be useful for debugging but it is not allowed for prod versions of filter lists.

### Examples

1. Remove `Period` tag whose `id` contains `-ad-` from all requests

    ```adblock
    example.org#%#//scriptlet('xml-prune', 'Period[id*="-ad-"]')
    ```

    Input XML:

    ```xml
    <Period id="main"/>
    <Period id="123-ad-456"/>
    ```

    Resulting XML:

    ```xml
    <Period id="main"/>
    ```

1. Remove `Period` tag whose `id` contains `-ad-`, only if XML contains `SegmentTemplate`

    ```adblock
    example.org#%#//scriptlet('xml-prune', 'Period[id*="-ad-"]', 'SegmentTemplate')
    ```

    Input XML:

    ```xml
    <Period id="preroll-ad">
      <SegmentTemplate />
    </Period>
    <Period id="content"/>
    ```

    Resulting XML:

    ```xml
    <Period id="content"/>
    ```

1. Remove `Period` tag whose `id` contains `-ad-`, only if request's URL contains `.mpd`

    ```adblock
    example.org#%#//scriptlet('xml-prune', 'Period[id*="-ad-"]', '', '.mpd')
    ```

    Input XML:

    ```xml
    <Period id="intro"/>
    <Period id="ads-ad-block"/>
    ```

    Resulting XML:

    ```xml
    <Period id="intro"/>
    ```

1. Remove `Period` tag whose `id` contains `-ad-`, only if request's URL contains `.mpd` and log content

    ```adblock
    example.org#%#//scriptlet('xml-prune', 'Period[id*="-ad-"]', '', '.mpd', 'true')
    ```

    Input XML:

    ```xml
    <Period id="pre-roll-ad"/>
    <Period id="movie"/>
    ```

    Resulting XML:

    ```xml
    <Period id="movie"/>
    ```

1. Remove `Period` tag whose `id` contains `pre-roll` and remove `duration` attribute from the `Period` tag
   by using XPath expression

    <!-- markdownlint-disable line-length -->

    ```adblock
    example.org#%#//scriptlet('xml-prune', 'xpath(//*[name()="Period"][contains(@id, "pre-roll") and contains(@id, "-ad-")] | //*[name()="Period"]/@duration)')
    ```

    <!-- markdownlint-enable line-length -->

    Input XML:

    ```xml
    <Period id="pre-roll-ad" duration="PT5S"/>
    <Period id="main" duration="PT30M"/>
    ```

    Resulting XML:

    ```xml
    <Period id="main"/>
    ```

1. Call with no arguments will log response payload and URL at the console

    ```adblock
    example.org#%#//scriptlet('xml-prune')
    ```

1. Call with only `urlToMatch` argument will log response payload and URL only for the matched URL

    ```adblock
    example.org#%#//scriptlet('xml-prune', '', '', '.mpd')
    ```

[Scriptlet source](../src/scriptlets/xml-prune.js)

* * *