Статьи

Снять один элемент или прямоугольник

Селектор снимает один узел. Clip снимает прямоугольник в координатах страницы. И то и другое заменяет изображение всей страницы. Если селектор задан и ничего не совпало, задание завершается ошибкой: так и задано по умолчанию.

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

CSS-селектор

selector принимает один CSS-селектор, до 500 символов. selector_scroll_into_view по умолчанию равен true, поэтому узел попадает в видимую область до съёмки. selector_algorithm принимает default или clip. clip снимает прямоугольник элемента, а не просит браузер снять сам узел. Селектор, который пересекает shadow root, может поставить shadow/ между внешним селектором и внутренним, как в widget shadow/ .price.

Прямоугольник вместо узла

clip_x и clip_y задают начало. clip_x идёт от 0 до 20 000, clip_y — от 0 до 30 000. clip_width идёт от 1 до 20 000, clip_height — от 1 до 30 000. Отправьте ширину и высоту вместе с нужным началом. capture_beyond_viewport по умолчанию равен true, поэтому прямоугольник ниже первого экрана всё ещё можно снять. Задайте full_page равным false, если прямоугольник — весь нужный вам результат.

Отсутствующий элемент завершает задание ошибкой

error_on_selector_not_found по умолчанию равен true, когда задан selector. Съёмка завершается ошибкой, а не картинкой не той области. Выключайте флаг только тогда, когда отсутствующий элемент всё равно должен дать снимок. Клик и наведение устроены так же, эти поля разобраны в статье про ожидание. Сначала скройте баннер, если он закрывает названный вами элемент.

Поля

Имена, которые принимает этот запрос
selector CSS-селектор для съёмки, до 500 символов. Через shadow/ можно войти в shadow root.
selector_algorithm default или clip, чтобы снять элемент как прямоугольник.
selector_scroll_into_view Прокручивает элемент в видимую область до съёмки. По умолчанию true.
error_on_selector_not_found Завершает задание ошибкой, если селектор ничего не нашёл. По умолчанию true, когда селектор задан.
clip_x Левый край прямоугольника, от 0 до 20 000.
clip_y Верхний край прямоугольника, от 0 до 30 000.
clip_width Ширина прямоугольника, от 1 до 20 000.
clip_height Высота прямоугольника, от 1 до 30 000.

Вопросы

Останется ли в файле остальная страница?

Файл — это элемент или clip. Задайте full_page, если нужна страница, и не задавайте селектор. Фрагменты относятся к полной странице, а не к одному элементу.

Что будет, если селектор ничего не нашёл?

Задание завершается ошибкой. Так и работает error_on_selector_not_found по умолчанию. Статус становится failed, и URL изображения нет.

Может ли селектор нажать кнопку, а потом снять другой узел?

Да. click и hover выполняются до съёмки. wait_for_selector ждёт, пока появится узел. Эти поля разобраны в статье про ожидание.

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

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

Сравнения

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

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