Скриншоты страниц и элементов

Весь захват в chromedp стоит на одной команде протокола, а библиотека даёт три обёртки. CaptureScreenshot снимает вьюпорт браузера — то, что влезает в окно; формат по умолчанию PNG. FullScreenshot включает захват за пределами видимой области и снимает страницу целиком; действие принимает качество от 0 до 100, и от него зависит формат: сотня даёт PNG, всё остальное — JPEG. Screenshot по селектору снимает первый совпавший элемент: chromedp вычисляет прямоугольник из getBoundingClientRect, округляет координаты до пикселей и захватывает этот участок холста. Трёх уровней хватает на все типовые задачи: быстрый кадр для дашборда, архив длинных страниц, точечная съёмка карточки или графика. Поэтому chromedp скриншот выглядит как одно действие после Navigate и ожидания — вся разница между кадрами в выборе команды и в том, что случится до нажатия, а не после. Общего у всех трёх и немного: все они возвращают срез байтов, все снимают текущее состояние рендера и ни одна не умеет пересниматься сама — если момент выбран неудачно, кадр придётся сделать заново.

Headless-окно в chromedp стартует без флага window-size — с невысокой дефолтной высотой и шириной, и страница раскладывается на нём, как будто у посетителя карманный телефон. Скриншот десктопной витрины из такого кадра выходит сломанным: колонки наползают, меню схлопывается в бургер, футер переезжает. Исходный размер задаётся опцией WindowSize(width, height), и это опция аллокатора, а не действие внутри Run: размер живёт с процессом браузера, а не с сессией страницы. Набор опций собирают через append по копии DefaultExecAllocatorOptions — сам глобальный срез менять нельзя, он читается всеми запускаемыми браузерами, — и передают в NewExecAllocator. Только поверх контекста аллокатора создаётся привычный NewContext, в котором живёт вкладка. Если нужны кадры мобильной витрины, вместо ручного подбора размеров есть Emulate с готовыми профилями устройств — они подменяют и вьюпорт, и сенсорный ввод, и строку агента. Отсюда порядок любого скриншота сайта go-программой: сначала кадр, потом страница, потом съёмка; второе окно другого размера — это второй процесс, а не изменение размеров текущего.

Элементные съёмки нужны чаще, чем кажется: карточка товара в архив, график в отчёт, форма с багом в тикет. Screenshot(sel, &buf) снимает первый узел, совпавший с селектором, и добавляет условие NodeVisible по умолчанию — скрытые элементы никто не снимает. Механика повторяет команду Capture node screenshot из панели DevTools, но с нюансом, о котором честно говорят комментарии в исходниках: chromedp не отправляет несколько вспомогательных команд протокола, что шлёт панель, и на экзотических страницах кадр может отличаться — тогда помогает прокрутка или расширение окна. Масштаб задаёт ScreenshotScale с явным коэффициентом. Когда одним прямоугольником нужно снять группу узлов, узлы достают действием Nodes в срез и передают в ScreenshotNodes(nodes, scale, &buf): считается общий охват от самого левого верхнего до самого правого нижнего. Так собирают кадр из карточки с плавающими элементами или пары соседних блоков, которые в одиночку смысла не имеют. И не забывайте про формат: элементная съёмка всегда PNG — вес кадра на больших областях быстро растёт, поэтому гигантские карточки снимают FullScreenshot с качеством ниже сотни, если границы позволяют.

Скриншот — момент, остановленный во времени, и его качество решается выбором момента. Ранний захват — самый частый брак: в кадре спиннер, пустой контейнер, недорисованный график. Базовая защита — WaitVisible на узле, который несёт смысл кадра: снимаем карточку — дожидаемся карточки, снимаем график — дожидаемся холста. Но видимость не равна готовности: шрифты доезжают позже разметки, анимации доигрывают, ленивые картинки ещё не приехали. Для сложных случаев пригодятся умные ожидания: дождаться JavaScript-условия, что данные приехали, и только потом снимать. Для ленивых списков работает приём: прокрутить страницу до низа, дать картинкам загрузиться, вернуться наверх и снимать — уже загруженные изображения при съёмке не пропадут, а пустые плейсхолдеры в кадре не нужны никому. Отдельная категория — canvas и графики: они рисуются скриптом в момент, который странице виднее, и единственная надёжная проверка готовности — условие на JavaScript из данных самой страницы, например флаг, который рисующий код выставляет в конце. Проверенный порядок — дожидаться, снимать, открывать файл глазами хотя бы в первый день работы парсера: брак в скриншотах узнаётся быстрее, чем в числах.

Буфер в действиях перезаписывается на каждом вызове, поэтому в цикле хватает одного var buf []byte — при условии, что вы отдаёте файл на диск до следующей съёмки, а не копите кадры. Имя собирайте из данных: дата, объект, тип захвата; такой архив потом ищется по имени и раскладывается по папкам без ручной работы. Для длинных серий следите за памятью процесса: Chrome растёт на тяжёлых страницах, и час непрерывных скриншотов — повод перезапустить контекст или вынести съёмку в пул браузеров, где время жизни процесса определяется задачей, а не длиной списка. И помните про качество кадра: переснятое — это прогон заново, навигация и ожидания; дешевле дождаться рендера, чем объяснять заказчику, почему в отчёте двести серых прямоугольников. Хороший тон — контроль брака в самой программе: проверка размера буфера и сравнение соседних кадров по контрольным суммам ловят пустые съёмки раньше, чем они доедут до отчёта.