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

Referenz für Fortgeschrittene · Fortgeschritten

Syntax kosmetischer Filter

Blende passende Seitenelemente mit unterstütztem CSS und begrenzten Regeln für wörtlichen Text aus.

Überblick

Eine kosmetische Regel blendet ein Element auf einer Seite aus. Sie bricht die Netzwerkanfragen dieses Elements nicht ab, löscht die zugrunde liegenden Informationen nicht und trifft keine Einwilligungsentscheidung für eine Website. Nutze eine Netzwerkregel, wenn du Anfragen blockieren willst.

Schreib eng gefasste Selektoren und prüfe sie in Deine Regeln. Eine Regel, die auf einen großen Container zielt, kann auch nützliche Bedienelemente ausblenden. Lade die Seite neu, wenn du eine Änderung prüfst.

Syntax

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

Zweck Beispiel Erwartete Wirkung Einschränkungen
Per CSS-Selektor auf einem Host ausblenden news.example##.advertisement Blendet Elemente, die auf .advertisement passen, auf diesem Host und seinen Subdomains aus. Wenn sich ein Klassenname ändert, passt die Regel möglicherweise nicht mehr.
Allgemein ausblenden ##.advertisement Bietet den Selektor auf allen Websites an. Viel größerer Geltungsbereich; dieselbe Klasse kann anderswo nützliche Inhalte bezeichnen.
Einen Host ausschließen news.example,~pay.news.example##.advertisement Beschränkt das Ausblenden auf den eingeschlossenen Bereich und schließt die genannte Subdomain aus. Kommas trennen kosmetische Host-Bereiche; das unterscheidet sich von $domain= bei Netzwerkregeln.
Ein passendes Ausblenden verhindern news.example#@#.advertisement Nimmt den passenden Selektor auf dieser Website aus. Erlaubt keine blockierte Netzwerkanfrage und schaltet nicht jede kosmetische Regel aus.
Native CSS-Beziehungen nutzen news.example##.card:has(.ad-label) Blendet eine Karte aus, die das passende Kind- oder Nachfahrenelement nach CSS-Semantik enthält. Natives :has(), :is(), :not() und :where() werden als CSS durchgereicht; sie schalten keine prozedurale Sprache anderer Blocker frei.
Wörtlichen Text abgleichen news.example##.card:has-text(Sponsored) Blendet passende Karten aus, deren Text diesen wörtlichen Text enthält. Ein Host-Bereich, ein sicheres Selektor-Präfix und ein nicht leerer Text sind erforderlich; der Abgleich beachtet Groß- und Kleinschreibung und ist begrenzt.

Kosmetische Entity-Bereiche wie example.*##.advertisement werden getrennt von Netzwerk-Bereichen zugelassen. Kopier diesen Platzhalter nicht in eine Netzwerkoption $domain= in der Annahme, dass er dort genauso unterstützt wird.

Abgleich mit wörtlichem Text

Die begrenzte Form :has-text() mit wörtlichem Text kann ## oder #?# nutzen. Die zugehörigen Ausnahmen nutzen #@# oder #@?#. Eine Ausnahme muss Selektor-Präfix, Operator und Text genau treffen, um dieses prozedurale Ausblenden zu verhindern.

Setz bei einer einfachen Regel den Textoperator ans Ende des Selektors. Ein Abgleich mit wörtlichem Text ist kein regulärer Ausdruck. /Sponsored/ ist hier zum Beispiel kein Weg, einen Abgleich per Regex anzufordern; :has-text mit Regex wird abgelehnt.

Die Auswertung begrenzt bewusst den Aufwand für Kandidaten und das Lesen von Text. Ein sehr großes Element, ein später Kandidat oder eine komplexe Seite kann sichtbar bleiben, auch wenn ein Mensch den Text irgendwo darin sieht. Das ist eine Schutzgrenze und kein Beweis, dass eine breitere Textregel nötig ist.

Grenzen

Shield lehnt Textausblendungen ohne Domain, Regex-Textargumente, mehrere Textoperatoren und prozedurale Funktionen wie :xpath(), :upward() und :style() ab. Ein abgelehnter prozeduraler Operator wird nicht dadurch unterstützt, dass du ihn in natives :has() einbettest. Andere Selektor-Kombinationen, die sich nicht genau abbilden lassen, werden als ganze Zeile übersprungen.

Behandle beliebige HTML-Filterung, das Einfügen von Stilen oder den erweiterten Selektor-Katalog eines anderen Blockers nicht als unterstütztes CSS. Ein Selektor, den der Parser akzeptiert, muss trotzdem im Browser gültig sein und zum aktuellen Markup der Website passen. Einstellungen wie eine pausierte Werbeausblendung, eine Pause für die Website oder eine Ausnahme für die ganze Seite können ansonsten gültige Ausblendungen zurückhalten.

Beispiele

news.example##.advertisement
pay.news.example#@#.advertisement

Die erste Zeile blendet die genannte Klasse im Bereich der Website aus. Die zweite verhindert genau dieses Ausblenden auf der Subdomain für Zahlungen. Netzwerkanfragen, die eine separate Regel blockiert hat, lässt sie nicht wieder zu.

Bei versehentlichem Ausblenden beginn mit der Wiederherstellung der Website. Ein ausgeblendetes Bedienelement anzeigen ist eine eng begrenzte Hilfe zur Wiederherstellung bei einem bestehenden Ausblenden; es ist kein Auswahlwerkzeug, um beliebige neue Ausblenderegeln zu schreiben.

Brauchst du noch Hilfe? Kontaktiere den Support