Diese Seite ist eine Übersetzung. Bei Abweichungen gilt die englische Seite.

Referenz für Fortgeschrittene · Fortgeschritten

Seitenkorrekturen und Scriptlets

Versteh mitgelieferte Seitenkorrekturen und die Scriptlet-Syntax. Shield AdBlock 1.0.2 führt diese Syntax nicht aus hinzugefügten Quellen oder eigenen Regeln aus.

Überblick

Seitenkorrekturen nutzen kleine, mit Shield mitgelieferte Helfer, um eng umrissenes Verhalten auf Seiten zu ändern. Ein Filter kann einen unterstützten Helfer und dessen Argumente auswählen; er kann keinen neuen JavaScript-Code liefern, den Shield herunterlädt und ausführt.

Der Schalter Seitenkorrekturen steuert die integrierten Korrekturen. Diese mitgelieferten Korrekturen bleiben eine eigene Einstellung und nutzen weiterhin die mit Shield mitgelieferten Helfer. In den Paketen von Shield AdBlock 1.0.2 für Chrome, Edge und Firefox sind Korrekturen aus hinzugefügten Quellen und Scriptlets aus Regeln, die du schreibst, bewusst nicht enthalten. Erweiterte Einstellungen kann erweiterte Bedienelemente anzeigen; das Anzeigen fügt diese nicht enthaltene Stufe nicht hinzu.

Diese Pakete der Version 1.0.2 enthalten die integrierten Korrekturen; die Scriptlet-Stufe für hinzugefügte Quellen und eigene Regeln ist bewusst nicht enthalten. Inhalte, die von anderen Websites eingebettet sind, bleiben möglicherweise unberührt, auch wenn eine integrierte Korrektur auf der Hauptseite funktioniert.

Syntax

Die Beispiele in dieser Anleitung zeigen die Filtersyntax. Es sind keine Scriptlets, die in den Paketen von Shield AdBlock 1.0.2 aus hinzugefügten Quellen oder eigenen Regeln ausgeführt werden. Die mitgelieferten Seitenkorrekturen nutzen weiterhin die mitgelieferten Helfer, wenn diese Einstellung eingeschaltet ist.

Nutze eine Form mit Host-Bereich wie:

news.example##+js(set-constant, adBlockDetected, false)

Damit wird der mitgelieferte Helfer set-constant für diese Website angefordert. Das ist kein JavaScript-Quelltext, kein CSS und keine Garantie, dass die Website diese Eigenschaft nutzt. Argumente werden durch Kommas getrennt; ein maskiertes Komma zählt als normales Zeichen, und eine passende äußere Ebene von Anführungszeichen wird entfernt.

Aktuelle Helfer

Diese Version erkennt die folgenden zehn kanonischen Namen. Die Angaben zur Zahl der Argumente zählen den Namen des Helfers nicht mit. Die Beispiele zeigen den Aufruf innerhalb von +js(...); setz vor jeden einen bewusst gewählten Website-Bereich, etwa news.example##.

Scrolle seitwärts, um die ganze Tabelle zu lesen.

Helfer und Aliase Zweck und Argumente Beispiel Erwartete Wirkung und Grenzen
set-constant; set Setzt eine Eigenschaft mit Punktnotation auf einen erlaubten Wert; genau 2 Argumente. +js(set-constant, adBlockDetected, false) Richtet das unterstützte Konstanten-Verhalten ein. Beliebige Zeichenketten, Code und unbegrenzte Zahlen werden abgelehnt.
abort-current-script; acs, abort-current-inline-script, acis Stoppt ein laufendes Skript beim Zugriff auf eine Eigenschaft; Eigenschaft plus optionale Suchtexte für Inhalt und Quelle, 1–3 Argumente. +js(abort-current-script, adblock) Wirkt auf passende Skriptzugriffe, nicht auf jedes Skript der Seite. Suchtexte müssen wörtlich sein.
abort-on-property-read; aopr Stoppt Code, wenn er eine Eigenschaft liest; genau 1 Argument. +js(abort-on-property-read, adblock) Betrifft die genannte Eigenschaftskette, die ein einfacher Bezeichnerpfad mit Punktnotation sein muss.
abort-on-property-write; aopw Stoppt Code, wenn er eine Eigenschaft schreibt; genau 1 Argument. +js(abort-on-property-write, antiAdblock.write) Zielt auf diese Eigenschaftskette; das kann legitimen Code beschädigen, der dorthin schreibt.
prevent-addEventListener; aeld, addEventListener-defuser Verhindert das Registrieren passender Listener; wörtliche Angaben für Ereignis und Handler-Quelltext, genau 2 Argumente. +js(prevent-addEventListener, click, antiAdblock) Beide Bedingungen müssen passen. Leere Prädikate oder ! können die Anforderung nicht bedingungslos machen; Regex und zusätzliche Optionen anderer Blocker werden abgelehnt.
prevent-fetch; no-fetch-if Verhindert passende Fetch-Aufrufe der Seite; Bedingung plus optionales Antwort-Token, 1–2 Argumente. +js(prevent-fetch, url:ads method:POST, emptyObj) Passt auf alle angegebenen wörtlichen Bedingungen und liefert die gewählte leere Antwort. Bricht nicht jeden Anfragetyp auf Browserebene ab.
prevent-xhr; no-xhr-if Verhindert passende XMLHttpRequests; Bedingung plus optionales Antwort-Token, 1–2 Argumente. +js(prevent-xhr, url:collect method:POST, emptyArr) Nutzt Prädikate für URL und Methode; Bedingungen mit mode:, die nur für Fetch gelten, werden abgelehnt.
json-prune Entfernt JSON-Eigenschaften; zu entfernende Pfade plus optionale erforderliche Pfade, 1–2 Argumente. +js(json-prune, payload.secret, payload.ready) Kürzt eine passende JSON-Struktur, wenn ihre erforderlichen Pfade vorhanden sind. Das ist eine begrenzte Pfadsprache, kein beliebiges JSONPath.
prevent-window-open; nowoif, no-window-open-if, window.open-defuser Verhindert passende Aufrufe von window.open; 0–1 wörtliches Argument. +js(prevent-window-open) Ohne Prädikat werden Aufrufe in seinem zulässigen Bereich verhindert. Der wörtliche Abgleich kann die zusammengefügten Aufrufargumente prüfen, nicht nur die URL; Optionen für Ersetzung und Verzögerung werden abgelehnt.
prevent-setTimeout; nostif, no-setTimeout-if, setTimeout-defuser Verhindert passende Timer; optionaler Suchtext für den Callback und optionale Verzögerung, 0–2 Argumente. +js(prevent-setTimeout, adRefresh, 1000) Passt auf den Callback-Text und die angegebene Verzögerung. Eine Verzögerung muss endlich sein; Regex-Argumente und zusätzliche Optionen werden abgelehnt.

Kanonische Namen und Aliase können auch die Endung .js tragen. Verwende in neuen Regeln lieber die kanonischen Namen, damit die Absicht leichter zu lesen ist.

Grenzen der Argumente

Eigenschafts-Helfer akzeptieren Bezeichner mit Punktnotation, keine Ausdrücke in eckigen Klammern, keine Funktionsaufrufe und keine Ketten, die in Prototypen reichen. set-constant akzeptiert die benannten Werte undefined, false, true, null, noopFunc, trueFunc, falseFunc, noopPromiseResolve, noopPromiseReject, emptyObj und emptyArr, die unterstützten leeren Formen sowie ganze Zahlen von −32767 bis 32767.

Anfrage-Helfer akzeptieren begrenzte, durch Leerzeichen getrennte wörtliche Bedingungen. Die Feldnamen sind url, method und, nur für Fetch, mode. Eine Bedingung ohne Feldnamen ist ein Teil der URL. Mit ! lässt sich eine Bedingung verneinen; alle Prädikate müssen passen. Antwort-Tokens sind der standardmäßige leere Text, emptyStr, emptyObj und emptyArr. Unbekannte Felder oder Antwort-Tokens werden abgelehnt.

Das Kürzen von JSON nutzt durch Leerzeichen getrennte Pfade mit Punktnotation. Ihre begrenzten Segmente können die unterstützten Formen *, [], [-] und {-} enthalten, mit Einschränkungen bei Position und Aufwand. Pfade, die in Prototypen reichen, werden abgelehnt. Verwende lieber einen einfachen benannten Pfad, es sei denn, du hast die genaue verschachtelte Struktur und die gewünschte Wirkung geprüft.

Grenzen

Dass ein Scriptlet-Name erkannt wird, reicht nicht, damit eine Regel ausgeführt wird. Anzahl und Syntax der Argumente, Website-Bereich und Schalter müssen passen, und das Paket muss diese Stufe enthalten. In den Paketen von Shield AdBlock 1.0.2 sind Scriptlets aus hinzugefügten Quellen und aus Regeln, die du schreibst, bewusst nicht enthalten; sie werden nicht ausgeführt. Eine Regel, die dieser Syntax entspricht, läuft deshalb weder aus einer Quelle, die du hinzugefügt hast, noch aus einer Regel, die du geschrieben hast. Regex-Argumente, unbekannte Namen und nicht unterstützte zusätzliche Optionen führen dazu, dass die ganze Regel übersprungen wird. Die Scriptlet-Syntax #%# von AdGuard wird nicht als Ersatz für ##+js(...) akzeptiert.

Integrierte Korrekturen haben ihre eigenen Voraussetzungen und ihren eigenen Registrierungsstatus. Eine erfolgreiche Einrichtung oder Registrierung beweist nicht, dass ein Helfer ausgeführt wurde, den beabsichtigten Aufruf abgefangen oder eine sichtbare Werbung entfernt hat. Kein Helfer garantiert das Entfernen von YouTube-Werbung oder die Kompatibilität mit jeder Version der Scriptlets eines anderen Blockers.

Beispiele

Um einen benannten Helfer auf einer Website auszuschalten, nutze eine Scriptlet-Ausnahme:

news.example#@#+js(set-constant)

Die Ausnahme nur mit Namen schaltet diesen Helfer im passenden Bereich aus. news.example#@#+js() ist die breitere Ausnahme für alle Scriptlets. Netzwerk- oder kosmetische Regeln werden dadurch nicht ausgeschaltet. Prüfe Ausnahmen so sorgfältig wie Aufrufe und lade die Website nach Änderungen neu.

Brauchst du noch Hilfe? Kontaktiere den Support