Updated Resources Library (markdown)

D4niloMR 2024-11-18 13:15:45 -03:00
parent 27d81f1099
commit 127b431c6b

@ -336,7 +336,8 @@ Logs to the console event listeners created on page.
The logging or debugging of `addEventListener()` calls can now be done with the [`addEventListenerDefuser`](#addeventlistener-defuserjs-) scriptlet, which now supports named arguments.
Also see: [AdGuard `log-addEventListener`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#log-addEventListener)
Also see:
- [AdGuard `log-addEventListener`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#log-addEventListener)
***
@ -457,9 +458,43 @@ New in [1.51.1b14](https://github.com/gorhill/uBlock/commit/cfac880cf51d8c652ce3
New in [1.52.3rc0](https://github.com/gorhill/uBlock/commit/1c9da227d714250c0b6319e2f635998f9869a70d)
Also see: [AdGuard `trusted-prune-inbound-object`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-trusted-scriptlets.md#trusted-prune-inbound-object)
To perform object pruning for any given call which has an object
as argument (hence "inbound").
Parameters:
- The name of the property to trap. Must be a function, and must
exist when the scriptlet tries to install the trap.
- The position of the object to prune in the argument list when
the trapped function is called. The position is 1-based and
must be an integer greater than 0.
- The properties to prune (as with [`json-prune`](#json-prunejs-))
- The properties which must all be present for pruning to occur
(as with [`json-prune`](#json-prunejs-))
Varargs:
- `stackToMatch`: string or regular expression that must match the current function call stack trace. Prepend pattern with `!` to test for unmatched patterns in stack trace.
- `, dontOverwrite, 1`: do not modify the target inbound object
Examples:
1. Remove `title` and `name` properties before passing the object to
`JSON.stringify` call:
```adblock
example.org##+js(trusted-prune-inbound-object, JSON.stringify, 1, title name)
```
2. Remove `status` property before passing the object to `Object.keys`
call but do not modify caller's instance of the object:
```adblock
example.org##+js(trusted-prune-inbound-object, Object.keys, 1, status, , dontOverwrite, 1)
```
Also see:
- [AdGuard `trusted-prune-inbound-object`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-trusted-scriptlets.md#trusted-prune-inbound-object)
[Documentation to be completed]
***
@ -469,7 +504,23 @@ Also see: [AdGuard `trusted-prune-inbound-object`](https://github.com/AdguardTea
New in [1.52.3rc3](https://github.com/gorhill/uBlock/commit/86f0d6dd978b79a34ffa257825539fb4446759a4)
[Documentation to be completed]
Essentially a complement of [`trusted-prune-inbound-object`](trusted-prune-inbound-objectjs-) added in [1.52.3rc0](https://github.com/gorhill/uBlock/commit/1c9da227d714250c0b6319e2f635998f9869a70d)
To perform object pruning on any object returned synchronously by
any given call.
Parameters:
- The name of the property to trap. Must be a function, and must
exist when the scriptlet tries to install the trap.
- The properties to prune (as with [`json-prune`](#json-prunejs-))
- The properties which must all be present for pruning to occur
(as with [`json-prune`](#json-prunejs-))
The scriptlets `json-prune` and `evaldata-prune` essentially
perform the same function, and will eventually be rewritten to
internally delegate to generic `trusted-prune-outbound-object`.
***
@ -565,7 +616,8 @@ tumblr.com##+js(json-prune-fetch-response, response.timeline.elements.[-].advert
nbc.com##+js(json-prune-fetch-response, avails, , propsToMatch, amazonaws.com)
```
Also see: [AdGuard `json-prune-fetch-response`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#json-prune-fetch-response)
Also see:
- [AdGuard `json-prune-fetch-response`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#json-prune-fetch-response)
***
@ -584,7 +636,7 @@ www.facebook.com##+js(json-prune-xhr-response, data.viewer.instream_video_ads da
```
Also see:
[AdGuard `json-prune-xhr-response`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#json-prune-xhr-response)
- [AdGuard `json-prune-xhr-response`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#json-prune-xhr-response)
***
@ -635,8 +687,7 @@ Also see:
***
### noeval.js [↪]
(https://github.com/gorhill/uBlock/blob/a94df7f3b27080ae2dcb3b914ace39c0c294d2f6/src/web_accessible_resources/noeval.js)
### noeval.js [](https://github.com/gorhill/uBlock/blob/a94df7f3b27080ae2dcb3b914ace39c0c294d2f6/src/web_accessible_resources/noeval.js)
Prevent web pages from using _`eval()`_, and report attempts to the logger. This should not be used as a generic filter due to the fact that it breaks many websites, including those using Cloudflare's DDoS protection.
Examples:
@ -741,7 +792,8 @@ For usage, see: [trusted-replace-fetch-response](#trusted-replace-fetch-response
Example:
- `in-jpn.com##+js(trusted-replace-xhr-response, /.*/, , pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?)`
Also see: [AdGuard `trusted-replace-xhr-response`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-trusted-scriptlets.md#trusted-replace-xhr-response)
Also see:
- [AdGuard `trusted-replace-xhr-response`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-trusted-scriptlets.md#trusted-replace-xhr-response)
***
@ -1188,8 +1240,8 @@ if not provided or empty, the scriptlet will only log the outbound text without
can be omitted if the goal is to delete the text which matches the pattern.
Tokens:
- `condition, pattern`: is a vararg which tells the scriptlet to act only if `pattern` is found in the argument to overwrite.
- `encoding, base64`: Decode and encode outbound base64 text before and after replacement. <sup>[1.58.1b3](https://github.com/gorhill/uBlock/commit/fa6740a059)</sup>
- `condition, pattern`: is a vararg which tells the scriptlet to act only if `pattern` is found in the outbound text.
- `encoding, base64`: Decode and encode outbound base64-encoded text before and after replacement. <sup>[1.58.1b3](https://github.com/gorhill/uBlock/commit/fa6740a059)</sup>
Examples:
- `www.reddit.com##+js(trusted-replace-outbound-text, JSON.stringify)` (logging only)
@ -1452,7 +1504,8 @@ example.org##+js(trusted-suppress-native-method, sessionStorage.setItem, ' |"ite
5. Abort `Array.prototype.concat([1, 'str', true, null])` calls by matching array argument contents.
6. Use stack argument to match by the call, while also matching the second argument.
Also see: [AdGuard `trusted-suppress-native-method`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-trusted-scriptlets.md#trusted-suppress-native-method)
Also see:
- [AdGuard `trusted-suppress-native-method`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-trusted-scriptlets.md#trusted-suppress-native-method)
***