Référence avancée · Avancé
Correctifs de pages et scriptlets
Comprendre les correctifs de pages intégrés et la grammaire des scriptlets. Shield AdBlock 1.0.2 ne l’exécute pas depuis les listes ajoutées ou vos règles.
Vue d’ensemble
Les Correctifs de pages utilisent de petits assistants intégrés à Shield pour modifier des comportements de page bien délimités. Un filtre peut choisir un assistant pris en charge et ses arguments ; il ne peut pas fournir de nouveau code JavaScript que Shield téléchargerait et exécuterait.
L’interrupteur Correctifs de pages contrôle les correctifs intégrés. Ces correctifs fournis restent un réglage distinct et utilisent toujours les assistants intégrés à Shield. Les paquets Shield AdBlock 1.0.2 n’incluent pas les Correctifs des sources ajoutées ni les scriptlets des règles que vous écrivez, sur Chrome, Edge et Firefox. Paramètres avancés peut afficher des commandes avancées ; les afficher n’ajoute pas ce niveau absent.
Ces paquets 1.0.2 contiennent les correctifs intégrés et n’incluent pas le niveau de scriptlets des listes ajoutées et des règles personnalisées. Le contenu intégré depuis d’autres sites peut ne pas être concerné, même quand un correctif intégré fonctionne sur la page principale.
Syntaxe
Les exemples de ce guide montrent la grammaire des filtres. Dans les paquets Shield AdBlock 1.0.2, ce ne sont pas des scriptlets exécutables issus de listes ajoutées ou de règles personnalisées. Les Correctifs de pages fournis continuent d’utiliser les assistants du paquet quand ce réglage est activé.
Utilisez une forme limitée à un hôte, par exemple :
news.example##+js(set-constant, adBlockDetected, false)
Cela demande l’assistant set-constant intégré au paquet pour ce site. Ce n’est ni du code source JavaScript ni du CSS, et cela ne garantit pas que le site utilise cette propriété. Les arguments sont séparés par des virgules ; une virgule échappée est littérale, et une couche extérieure de guillemets assortis est retirée.
Liste actuelle des assistants
Cette version reconnaît les dix noms canoniques suivants. Les plages d’arguments n’incluent pas le nom de l’assistant. Les exemples montrent l’appel à l’intérieur de +js(...) ; faites précéder chacun d’un périmètre de site choisi délibérément, comme news.example##.
Faites défiler horizontalement pour lire tout le tableau.
| Assistant et alias | Objectif et arguments | Exemple | Effet attendu et limites |
|---|---|---|---|
set-constant; set |
Donne à une propriété pointée une valeur autorisée ; exactement 2 arguments. | +js(set-constant, adBlockDetected, false) |
Met en place le comportement de constante pris en charge. Les chaînes arbitraires, le code et les nombres non bornés sont refusés. |
abort-current-script; acs, abort-current-inline-script, acis |
Arrête un script en cours lors de l’accès à une propriété ; propriété plus fragments facultatifs de contenu et de source, 1 à 3 arguments. | +js(abort-current-script, adblock) |
Agit sur l’accès des scripts correspondants, pas sur tous les scripts de la page. Les fragments doivent être littéraux. |
abort-on-property-read; aopr |
Arrête le code lorsqu’il lit une propriété ; exactement 1 argument. | +js(abort-on-property-read, adblock) |
Concerne la chaîne de propriétés indiquée, qui doit être un simple chemin d’identifiants séparés par des points. |
abort-on-property-write; aopw |
Arrête le code lorsqu’il écrit une propriété ; exactement 1 argument. | +js(abort-on-property-write, antiAdblock.write) |
Vise cette chaîne de propriétés ; peut casser du code légitime qui y écrit. |
prevent-addEventListener; aeld, addEventListener-defuser |
Empêche l’enregistrement des écouteurs correspondants ; littéraux d’événement et de source du gestionnaire, exactement 2 arguments. | +js(prevent-addEventListener, click, antiAdblock) |
Les deux conditions doivent correspondre. Des prédicats vides ou ! ne peuvent pas rendre toute la demande inconditionnelle ; les expressions régulières et les options supplémentaires d’autres bloqueurs sont refusées. |
prevent-fetch; no-fetch-if |
Empêche les requêtes fetch correspondantes de la page ; condition plus jeton de réponse facultatif, 1 à 2 arguments. | +js(prevent-fetch, url:ads method:POST, emptyObj) |
Exige que toutes les conditions littérales fournies correspondent et renvoie la réponse vide choisie. N’annule pas tous les types de requêtes au niveau du navigateur. |
prevent-xhr; no-xhr-if |
Empêche les XMLHttpRequest correspondantes ; condition plus jeton de réponse facultatif, 1 à 2 arguments. | +js(prevent-xhr, url:collect method:POST, emptyArr) |
Utilise des prédicats d’URL et de méthode ; les conditions mode:, propres à fetch, sont refusées. |
json-prune |
Supprime des propriétés JSON ; chemins à supprimer plus chemins requis facultatifs, 1 à 2 arguments. | +js(json-prune, payload.secret, payload.ready) |
Élague une structure JSON correspondante lorsque ses chemins requis existent. C’est un langage de chemins borné, pas du JSONPath arbitraire. |
prevent-window-open; nowoif, no-window-open-if, window.open-defuser |
Empêche les appels window.open correspondants ; 0 à 1 argument littéral. |
+js(prevent-window-open) |
Sans prédicat, empêche les appels dans son périmètre admissible. La correspondance littérale peut examiner l’ensemble des arguments de l’appel, pas seulement l’URL ; les options de remplacement et de délai sont refusées. |
prevent-setTimeout; nostif, no-setTimeout-if, setTimeout-defuser |
Empêche les minuteurs correspondants ; fragment facultatif de la fonction de rappel et délai facultatif, 0 à 2 arguments. | +js(prevent-setTimeout, adRefresh, 1000) |
Compare le texte de la fonction de rappel et le délai fourni. Le délai doit être fini ; les arguments en expression régulière et les options supplémentaires sont refusés. |
Les noms canoniques et les alias peuvent aussi porter le suffixe .js. Dans les nouvelles règles, privilégiez les noms canoniques pour que l’intention soit plus lisible.
Limites des arguments
Les assistants de propriétés acceptent des identifiants séparés par des points, pas d’expressions entre crochets, d’appels de fonctions ni de chaînes qui atteignent le prototype. set-constant accepte les valeurs nommées undefined, false, true, null, noopFunc, trueFunc, falseFunc, noopPromiseResolve, noopPromiseReject, emptyObj et emptyArr, les formes vides prises en charge et les entiers de −32767 à 32767.
Les assistants de requêtes acceptent des conditions littérales bornées, séparées par des espaces. Les noms de champs sont url, method et, pour fetch uniquement, mode. Une condition sans champ est une sous-chaîne de l’URL. La négation s’écrit avec ! ; tous les prédicats doivent correspondre. Les jetons de réponse sont le texte vide par défaut, emptyStr, emptyObj et emptyArr. Les champs et jetons de réponse inconnus sont refusés.
L’élagage JSON utilise des chemins pointés séparés par des espaces. Ses segments bornés peuvent inclure les formes prises en charge *, [], [-] et {-}, avec des restrictions de position et de traitement. Les chemins qui atteignent le prototype sont refusés. Préférez un chemin nommé simple, sauf si vous avez vérifié la structure imbriquée exacte et l’effet recherché.
Limites
Qu’un nom de scriptlet soit reconnu ne suffit pas pour qu’une règle s’exécute. Son nombre d’arguments, la grammaire des arguments, le périmètre du site et les interrupteurs doivent remplir les conditions, et le paquet doit inclure ce niveau. Les paquets Shield AdBlock 1.0.2 n’incluent pas les scriptlets des listes ajoutées et des règles personnalisées : une règle conforme à cette grammaire n’est donc pas exécutée depuis une liste que vous avez ajoutée ou une règle que vous avez écrite. Les arguments en expression régulière, les noms inconnus et les options supplémentaires non prises en charge font ignorer toute la règle. La syntaxe de scriptlets #%# d’AdGuard n’est pas acceptée à la place de ##+js(...).
Les correctifs intégrés ont leurs propres conditions d’application et leur propre état d’enregistrement. Une configuration ou un enregistrement réussi ne prouve pas qu’un assistant s’est exécuté, a intercepté l’appel visé ou a retiré une publicité visible. Aucun assistant ne garantit la suppression des publicités YouTube ni la compatibilité avec toutes les versions des scriptlets d’un autre bloqueur.
Exemples
Pour désactiver un assistant précis sur un site, utilisez une exception de scriptlet :
news.example#@#+js(set-constant)
L’exception avec le seul nom désactive cet assistant dans le périmètre correspondant. news.example#@#+js() est l’exception plus large qui couvre tous les scriptlets. Elles ne désactivent pas les règles réseau ou cosmétiques. Vérifiez les exceptions avec autant de soin que les appels et rechargez le site après chaque modification.