Статьи

Блокировать баннеры, рекламу и чаты

Чистый снимок — это параметр съёмки, а не таблица стилей на вашем хосте. Четыре переключателя убирают обычный мусор, а hide_selectors убирает то, что относится только к этому сайту.

Статьи по API скриншотов

Переключатели

block_cookie_banners, block_banners_by_heuristics, block_ads, block_trackers и block_chats по умолчанию равны false. Включите те, которые нужны странице. Баннеры cookie и баннеры по эвристике закрывают диалоги согласия. Реклама, трекеры и чаты закрывают сети и виджеты в углу. Ни одно из этих полей не меняет формат файла или окно.

Селекторы и сетевые правила

hide_selectors — список CSS-селекторов, которые нужно убрать перед съёмкой. Используйте его для полосы рассылки или акции, которых переключатели не знают. block_requests — список шаблонов URL, которые нужно остановить. block_resources — список типов ресурсов: document, stylesheet, image, media, font, script, texttrack, xhr, fetch, eventsource, websocket, manifest или other. Блокировка всех script заблокирует и страницу, поэтому указывайте именно те типы, которые имеете в виду.

Клик по баннеру

Некоторые баннеры входят в страницу и уходят только после клика. click принимает CSS-селектор и нажимает его перед съёмкой. Это другое поле, не переключатели блокировки, и его разбирает статья про ожидание. Если цель клика не найдена, задание завершается ошибкой, потому что error_on_click_selector_not_found по умолчанию равен true. Используйте переключатели блокировки, если не хотите поддерживать селектор для каждого сайта.

Поля

Имена, которые принимает этот запрос
block_cookie_banners Блокирует баннеры согласия cookie. По умолчанию false.
block_banners_by_heuristics Блокирует баннеры, найденные эвристикой. По умолчанию false.
block_ads Блокирует рекламу. По умолчанию false.
block_trackers Блокирует трекеры. По умолчанию false.
block_chats Блокирует виджеты чата. По умолчанию false.
hide_selectors CSS-селекторы, которые нужно скрыть. Передаются списком.
block_resources Типы ресурсов для блокировки, например script, image и font.

Вопросы

Нужно ли размещать CSS-файл, чтобы скрыть баннер?

Нет. Переключатели и hide_selectors передаются в теле JSON. styles по-прежнему может внедрить CSS, если вам нужно своё правило.

Сломает ли блокировка скриптов страницу?

Может. block_resources действует точно по списку. Не включайте script, если без него страница не отрисуется. Для обычного маркетингового сайта лучше переключатели баннеров и рекламы.

Баннер — это кнопка, а не слой, который можно скрыть. Что тогда?

Отправьте click с селектором кнопки. Клик выполняется до съёмки. Если этот селектор ничего не нашёл, задание завершается ошибкой.

Другие статьи

Альтернативы, которые используют эти поля

Сравнения

Отправьте первый адрес

Создайте аккаунт, скопируйте bearer-токен и отправьте POST с публичным адресом, HTML или Markdown.