Выполнение JavaScript: Evaluate

Сигнатура короткая: chromedp.Evaluate(expression, res). Первый аргумент — строка с выражением JavaScript, второй — указатель на приёмник результата; передадите nil, и результат будет проигнорирован, действие только исполнит код — так выглядит прокрутка window.scrollTo из седьмого урока. Механика возврата для обычных приёмников такая: результат выражения кодируется в JSON по значению, и стандартный json.Unmarshal раскладывает его в вашу переменную. Число ложится в int или float64, строка — в string, массив — в срез, объект — в карту или структуру с json-тегами. Это значит, что тип приёмника — ваша ответственность: выражение вернёт массив, а приёмник объявлен строкой — получите ошибку распаковки, и она будет честной ошибкой Go с описанием. Отсюда привычка подбирать пару «выражение плюс тип»: соберёте на JS массив строк — берите []string, посчитаете сумму — берите float64 или int, разберёте объект — карту map[string]any или структуру. Evaluate не дожидается ничего: он исполняет выражение в текущем состоянии страницы, поэтому перед ним стоят те же ожидания готовности, что и перед чтением узлов. Ошибка внутри выражения — обращение к несуществующему свойству, ошибка синтаксиса — возвращается как ошибка действия, и Run останавливается: тихого прохождения мимо не бывает.

Три особые формы приёмника закрывают края случая, и о них стоит знать заранее. Первая — ошибка undefined: если выражение вернуло undefined или null, а приёмник не умеет быть nil — строка, число, структура, — Evaluate вернёт ошибку: encountered an undefined value или encountered a null value. Приёмники, которые nil умеют, — указатели, срезы, карты — примут undefined молча: срез останется nil, и это штатный путь выразить «данных нет». Вторая особая форма — сырые байты: приёмник []byte получает JSON-кодировку результата как есть, без распаковки в тип; это способ забрать значение сложной формы и разобрать его у себя, когда писать JS-разбор не хочется, а промежуточная структура не нужна. Третья — низкоуровневый приёмник *runtime.RemoteObject: вы получаете объект протокола без попытки конвертации — класс объекта, идентификатор, тип; живые объекты браузер держит у себя, пока страница не закрыта или не переезжает, и освобождать их можно командами runtime.ReleaseObject, если сессия длинная и объектов много. Для повседневных задач хватает первого пути; RemoteObject нужен, когда результат — функция, узел DOM или большой объект, который вы хотите исследовать по частям, а не тащить целиком в Go.

Сила Evaluate провоцирует: раз можно всё — почему не перенести в JS-строку половину парсера? Здесь полезна граница, которую стоит провести заранее. Уместное: агрегаты одним обменом, прокрутка, чтение состояния, которое не попало в DOM — переменные скрипта, объекты аналитики, данные в памяти фреймворка; проверка сложной готовности, которую селектором не выразить. Неуместное: валидация, ветвления и маршрутизация парсера внутри JS-строк — код без типов, без отладчика Go, без тестов, и каждая правка — редактирование строки в кавычках. Спорное мнение с условием: логика должна жить в Go, а JS — только читать и трогать страницу; исключение, при котором мнение можно перевернуть, одно — когда страница сама держит данные в недоступном селекторам виде, и короткий JS-запрос к её состоянию экономит десятки действий. Хороший маркер уместности: если выражение умещается в одну-две строки и не содержит ветвлений, это работа для Evaluate; если третье — сигнал вернуться к действиям библиотеки. Второй практический предел — аргументы: у Evaluate нет параметра для значений, аргументы подставляются в строку выражения. Подставляйте через JSON-кодирование и экранирование, а не конкатенацией: сырая склейка строк с данными с сайта — прямой путь к сломанному выражению, а в худшем случае к исполнению чужого кода в вашей сессии. Для предикатов с аргументами есть PollFunction с WithPollingArgs из девятого урока — там подстановка безопасна и встроена.

Вторая обёртка над той же командой протокола — chromedp.EvaluateAsDevTools: выражение исполняется так, как его исполняет консоль панели разработчика. Разница в двух деталях: выражение живёт в контексте объекта группы console, и ему доступен Command Line API — те самые сокращения консоли, включая выбор элементов dollar-скриптами $ и $$. Для задач «сделай, как я сделал в DevTools» это прямой путь: выражение, проверенное в консоли, переносится в код без переписывания dollar-сокращений на чистый querySelector. У библиотеки на этом механизме стоят привычные действия: Title и Location из третьего урока — обёртки над EvaluateAsDevTools с выражениями document.title и document.location.toString(), так что вы уже пользовались этой обёрткой, не зная о ней. Цена за удобство обозначена в исходниках честно: не используйте EvaluateAsDevTools с недоверенным JavaScript — Command Line API расширяет возможности исполняемого кода, и запускать в этой песочнице стоит только то, что вы написали сами или проверили. Рядом живут и опции нижнего уровня: EvalIgnoreExceptions заставляет оценку не падать на исключениях, EvalAsValue принудительно кодирует результат по значению — те же рычаги, которыми настроена обычная обёртка.

Соберём дисциплину оценки в правила, которые проверены на живых страницах. Выражение сначала живёт в консоли DevTools: написали, исполнили, увидели результат — и только потом переехало в Go; между консолью и Evaluate почти нет разницы, а цикл отладки в консоли в десять раз короче. Приёмник подбирается под форму результата и объявляется рядом с выражением: массив текстов — []string, сумма — число, объект — карта или структура; расхождение формы и типа даёт ошибку распаковки с понятным текстом. Undefined и null обрабатываются сознательно: если «нет данных» — норма, берите приёмники, умеющие nil, и проверяйте на nil, а не на ошибку. Для страницы, где результат появляется позже, Evaluate окружается ожиданиями: WaitVisible на узле или Poll с предикатом из девятого урока — оценка сама ждать не умеет. Крупные вычисления по сотням узлов делаются одним выражением с map и reduce: на стороне браузера это микросекунды, а расписывать ту же работу десятками действий — тратить обмены и время обхода. И держите выражения короткими: трёхэтажная JS-программа в строке — сигнал, что пора выносить её в отдельный файл или возвращаться к действиям библиотеки.