Это переводная страница. При расхождениях действует английская версия.

Справочник для опытных · Для опытных

Синтаксис сетевых фильтров

Используйте проверенное подмножество сетевых правил и разберитесь в исключениях, областях и отклонённых строках.

Обзор

Shield принимает ограниченное подмножество языка фильтров, общего для многих списков блокировки. Строку, которую нельзя точно воспроизвести, он пропускает. Если удалить незнакомый параметр, чтобы строка прошла, её смысл может измениться; вместо этого посмотрите предварительный просмотр.

В примерах ниже используются зарезервированные домены для примеров. Они описывают поведение правил и не являются правилами, которые нужно устанавливать для реального сервиса. Добавляйте в Ваши правила по одной строке, проверяйте её область действия и применяйте только то изменение, которое задумали.

Синтаксис

Шаблоны URL

Прокрутите в сторону, чтобы увидеть всю таблицу.

Назначение Синтаксис и пример Ожидаемый результат и ограничения
Совпадение с хостом ||ads.example^ Совпадает с этим хостом и его поддоменами на границе имени хоста; не совпадает с notads.example. Правило без типа действует на обычные запросы, а не на переход к странице верхнего уровня.
Привязка URL |https://cdn.example/ads.js| Требует, чтобы URL начинался и заканчивался в этих позициях. Изменение схемы, пути или запроса может нарушить совпадение.
Совпадение с частью URL /ad/image/*$image Совпадает с URL запросов изображений, содержащими указанный путь, за которым следует переменный текст. Подстановочный знак в конце отличает его от регулярного выражения в косых чертах.
Подстановочный знак ||cdn.example/ads/* * совпадает с переменным текстом; ^ — с разделителем или концом URL. Для шаблонов с несколькими подстановочными знаками есть ограничения на приём и объём работы; шаблоны произвольного размера не принимаются.

В шаблонах используется текст URL в ASCII. Не добавляйте #fragment: браузер не отправляет фрагменты URL в составе сетевого запроса.

Типы, источники и области сайтов

Прокрутите в сторону, чтобы увидеть всю таблицу.

Назначение Пример Ожидаемый результат и ограничения
Ограничение типа запроса ||ads.example^$script Действует на скрипты. Другие типы: image, stylesheet, font, media, object, xmlhttprequest, subdocument, document, ping, websocket и other. Псевдонимы: css, xhr, frame и doc.
Исключение типа ||ads.example^$~image Исключает изображения. Правило только с отрицаниями по-прежнему исключает документы верхнего уровня и не превращается в правило блокировки страниц.
Все типы ||ads.example^$all Явно включает документы верхнего уровня. $all,~script включает остальные учитываемые типы. Используйте осторожно.
Ограничение по источнику ||ads.example^$third-party Действует, если запрос сторонний по отношению к сайту, который его инициировал. 3p — псевдоним; first-party, 1p, ~third-party и ~3p выбирают собственные запросы.
Ограничение сайта-инициатора ||ads.example^$domain=news.example Ограничивает совпадение запросами, которые инициировал этот хост. Исключённые хосты-инициаторы можно добавить, как показано ниже. Подстановочные знаки сущностей в сетевых областях $domain= отклоняются.

В области включения и исключения между именами хостов ставится |, а перед исключённым хостом — ~:

||ads.example^$domain=news.example|~pay.news.example

Исключения и приоритет

@@||ads.example^$script,domain=shop.example разрешает совпадающие запросы скриптов, инициированные указанным сайтом. Это не приостанавливает всю защиту на этом сайте.

Обычное совпадающее исключение важнее обычной блокировки. Блокировка с $important важнее обычного исключения; исключение с $important важнее такой важной блокировки. Текст, который выглядит более конкретным, не задаёт общей системы приоритетов.

Для исключения на всю страницу @@||shop.example^$document отключает защиту для совпадающей страницы верхнего уровня и всего, что она загружает. В этой форме нельзя добавить условие источника, область домена-инициатора, дополнительные типы ресурсов или $all. $document без исключения — это блокировка документа верхнего уровня, а не пауза.

@@||news.example^$generichide отключает общее косметическое скрытие на этом хосте. Косметические правила для конкретного сайта и блокировка запросов продолжают действовать. Принимается только исключение на чистой привязке к хосту; пути, условия источника и другие области типов в эту форму только для хоста не переносятся.

||popups.example^$popup сопоставляет адреса перехода во всплывающих окнах с помощью обработчика всплывающих окон Shield. @@||accounts.example^$popup,domain=shop.example — исключение для всплывающих окон с ограниченной областью. Это не правила для запросов скриптов, и они не настраивают встроенную блокировку всплывающих окон в браузере.

Не сочетайте $popup с типами запросов, $all, $generichide или действием перенаправления: одна строка не может описать обе области. Если проблема с окном входа, начните с раздела окна входа и оплаты.

Файлы hosts и условные блоки

Стандартные записи hosts с «пустыми» адресами 0.0.0.0, 127.0.0.1, ::1, :: или 0 преобразуются в правила с привязкой к хосту. Например, 0.0.0.0 ads.example становится эквивалентом ||ads.example^. Другие сетевые записи, разделённые пробелами, отклоняются.

В списках можно использовать вложенные !#if, !#else и !#endif с !, &&, || и скобками. Условия вычисляются для целевого пакета Shield. Распознаваемые как истинные общие условия — true, env_mv3 и cap_user_stylesheet; env_chromium и env_firefox зависят от цели. Неизвестные константы считаются ложными. Эти директивы выбирают ветви списка, а не условия на открытой странице.

Безвредные перенаправления

Принимается закрытый набор ресурсов: redirect=noopjs или redirect=noop.js подставляет пустой скрипт; redirect=nooptext или redirect=noop.txt — пустой текст; redirect=noopjson — {}. Например, ||ads.example/tracker.js$script,redirect=noopjs подставляет безвредный скрипт, когда это правило срабатывает.

Это замены, встроенные в пакет, а не перенаправления на произвольные URL и не полная эмуляция сторонней библиотеки. Неизвестные имена ресурсов и действия перенаправления в правилах-исключениях отклоняются. Конкурирующая жёсткая блокировка с тем же приоритетом может оказаться важнее перенаправления.

Ограничения

Сетевые фильтры с регулярными выражениями, removeparam, csp, badfilter, redirect-rule и неизвестные модификаторы отклоняются целой строкой. Этот справочник не обещает совместимость со всеми возможностями EasyList, uBlock Origin или AdGuard. Если синтаксиса здесь нет, это не доказывает, что его проверили и отклонили.

Принятые правила всё равно могут превысить возможности браузера или быть перекрыты настройками защиты и исключениями. Проверьте предварительный просмотр и состояние защиты; настроенное правило не доказывает, что оно действует на странице.

Примеры

Точная пара из блокировки и исключения:

||ads.example^$script,third-party
@@||ads.example^$script,domain=checkout.example

Первая строка блокирует совпадающие сторонние скрипты. Вторая разрешает совпадающие запросы скриптов, инициированные checkout.example. После перезагрузки проверьте реальный сценарий работы сайта: разрешённый запрос может пропустить и рекламу или отслеживание.

Нужна помощь? Свяжитесь с поддержкой