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

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

Исправления страниц и скриптлеты

Встроенные исправления страниц и грамматика скриптлетов. Shield AdBlock 1.0.2 не выполняет её из добавленных списков и ваших правил.

Обзор

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

Переключатель Исправления страниц управляет встроенными исправлениями. Эти встроенные исправления остаются отдельной настройкой и по-прежнему используют функции, входящие в Shield. В пакетах Shield AdBlock 1.0.2 для Chrome, Edge и Firefox нет Исправления из добавленных источников и скриптлетов из правил, которые вы пишете сами. Расширенные настройки могут показать дополнительные элементы управления, но их отображение не добавляет этот отсутствующий уровень.

Эти пакеты 1.0.2 содержат встроенные исправления, но в них нет уровня скриптлетов из добавленных списков и пользовательских правил. Контент, встроенный с других сайтов, может остаться без изменений, даже если встроенное исправление работает на основной странице.

Синтаксис

Примеры в этом руководстве показывают грамматику фильтров. В пакетах Shield AdBlock 1.0.2 это не исполняемые скриптлеты из добавленных списков или пользовательских правил. Встроенные исправления страниц продолжают использовать функции из пакета, когда эта настройка включена.

Используйте форму с привязкой к хосту, например:

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

Эта запись запрашивает для данного сайта функцию set-constant из пакета. Это не исходный код JavaScript и не CSS, а также не гарантия того, что сайт использует это свойство. Аргументы разделяются запятыми; экранированная запятая воспринимается буквально, а один внешний слой парных кавычек удаляется.

Текущий список функций

Эта сборка распознаёт десять канонических имён, перечисленных ниже. Диапазоны аргументов не учитывают имя функции. В примерах показан вызов внутри +js(...); перед каждым добавляйте осознанно выбранную область сайта, например news.example##.

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

Функция и псевдонимы Назначение и аргументы Пример Ожидаемый результат и ограничения
set-constant; set Присваивает свойству с точечной записью одно из допустимых значений; ровно 2 аргумента. +js(set-constant, adBlockDetected, false) Устанавливает поддерживаемое поведение константы. Произвольные строки, код и неограниченные числа отклоняются.
abort-current-script; acs, abort-current-inline-script, acis Останавливает текущий скрипт при обращении к свойству; свойство плюс необязательные фрагменты содержимого и источника, 1–3 аргумента. +js(abort-current-script, adblock) Действует на обращения совпадающих скриптов, а не на все скрипты страницы. Фрагменты должны быть буквальными.
abort-on-property-read; aopr Останавливает код, когда он читает свойство; ровно 1 аргумент. +js(abort-on-property-read, adblock) Затрагивает указанную цепочку свойств — она должна быть простым путём из идентификаторов через точку.
abort-on-property-write; aopw Останавливает код, когда он записывает свойство; ровно 1 аргумент. +js(abort-on-property-write, antiAdblock.write) Нацелена на эту цепочку свойств и может нарушить работу законного кода, который туда записывает.
prevent-addEventListener; aeld, addEventListener-defuser Не даёт зарегистрировать совпадающие обработчики событий; буквальные значения события и исходного кода обработчика, ровно 2 аргумента. +js(prevent-addEventListener, click, antiAdblock) Должны совпасть оба условия. Пустые условия или ! не делают запрос безусловным; регулярные выражения и дополнительные параметры других блокировщиков отклоняются.
prevent-fetch; no-fetch-if Предотвращает совпадающие запросы fetch на странице; условие плюс необязательный токен ответа, 1–2 аргумента. +js(prevent-fetch, url:ads method:POST, emptyObj) Требует совпадения всех указанных буквальных условий и возвращает выбранный пустой ответ. Не отменяет все типы запросов на уровне браузера.
prevent-xhr; no-xhr-if Предотвращает совпадающие XMLHttpRequest; условие плюс необязательный токен ответа, 1–2 аргумента. +js(prevent-xhr, url:collect method:POST, emptyArr) Использует условия по URL и методу; условия mode:, доступные только для fetch, отклоняются.
json-prune Удаляет свойства JSON; пути для удаления плюс необязательные обязательные пути, 1–2 аргумента. +js(json-prune, payload.secret, payload.ready) Обрезает совпадающую структуру JSON, если в ней есть обязательные пути. Это ограниченный язык путей, а не произвольный JSONPath.
prevent-window-open; nowoif, no-window-open-if, window.open-defuser Предотвращает совпадающие вызовы window.open; 0–1 буквальный аргумент. +js(prevent-window-open) Без условия предотвращает вызовы в своей допустимой области. Буквальное сравнение может проверять все аргументы вызова вместе, а не только URL; параметры замены и задержки отклоняются.
prevent-setTimeout; nostif, no-setTimeout-if, setTimeout-defuser Предотвращает совпадающие таймеры; необязательный фрагмент функции обратного вызова и необязательная задержка, 0–2 аргумента. +js(prevent-setTimeout, adRefresh, 1000) Сравнивает текст функции обратного вызова и указанную задержку. Задержка должна быть конечной; аргументы с регулярными выражениями и дополнительные параметры отклоняются.

Канонические имена и псевдонимы могут также иметь суффикс .js. В новых правилах лучше использовать канонические имена — так понятнее, что задумано.

Границы аргументов

Функции для свойств принимают идентификаторы через точку, но не выражения в квадратных скобках, вызовы функций или цепочки, затрагивающие прототип. set-constant принимает именованные значения undefined, false, true, null, noopFunc, trueFunc, falseFunc, noopPromiseResolve, noopPromiseReject, emptyObj и emptyArr, поддерживаемые пустые формы и целые числа от −32767 до 32767.

Функции для запросов принимают ограниченные буквальные условия, разделённые пробелами. Имена полей: url, method и, только для fetch, mode. Условие без имени поля — это подстрока URL. Отрицание задаётся с помощью !; должны совпасть все условия. Токены ответа: пустой текст по умолчанию, emptyStr, emptyObj и emptyArr. Неизвестные поля и токены ответа отклоняются.

Обрезка JSON использует пути через точку, разделённые пробелами. Их ограниченные сегменты могут содержать поддерживаемые формы *, [], [-] и {-} с ограничениями по позиции и объёму работы. Пути, затрагивающие прототип, отклоняются. Лучше используйте простой именованный путь, если только вы не проверили точную вложенную структуру и нужный результат.

Ограничения

Того, что имя скриптлета распознано, недостаточно для выполнения правила. Число аргументов, их грамматика, область сайта и переключатели должны соответствовать требованиям, а пакет должен включать этот уровень. В пакетах Shield AdBlock 1.0.2 нет скриптлетов из добавленных списков и пользовательских правил, поэтому правило, соответствующее этой грамматике, не выполняется ни из добавленного вами списка, ни из написанного вами правила. Аргументы с регулярными выражениями, неизвестные имена и неподдерживаемые дополнительные параметры приводят к пропуску всего правила. Синтаксис скриптлетов #%# из AdGuard не принимается вместо ##+js(...).

У встроенных исправлений свои условия применения и своё состояние регистрации. Успешная настройка или регистрация не доказывает, что функция выполнилась, перехватила нужный вызов или убрала видимую рекламу. Ни одна функция не гарантирует удаление рекламы на YouTube или совместимость со всеми версиями скриптлетов другого блокировщика.

Примеры

Чтобы отключить определённую функцию на сайте, используйте исключение для скриптлета:

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

Исключение только с именем отключает эту функцию в совпадающей области. news.example#@#+js() — более широкое исключение для всех скриптлетов. Они не отключают сетевые и косметические правила. Проверяйте исключения так же внимательно, как и вызовы, и перезагружайте сайт после изменений.

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