Клик и ввод текста

chromedp.Click работает не как вызов JavaScript-метода click(), а как рука пользователя: браузеру отправляются события мыши — нажатие и отпускание кнопки — по координатам найденного узла. Разница не академическая. Настоящие события мыши всплывают по дереву, будят обработчики наведения, активируют фокус и запускают всю цепочку реакций, которую сайт повесил на кнопку; программный click() через JS часто срабатывает только на самом узле и минует часть этой цепочки. Чтобы координаты вообще существовали, Click внутри себя дожидается видимости узла — условие NodeVisible добавляется к действию по умолчанию, — а невидимый элемент браузер при необходимости прокручивает в поле зрения: перед кликом выполняется ScrollIntoViewIfNeeded, поэтому элемент, оказавшийся ниже границы экрана, дотянется до видимой области сам. Из механики следуют два практических правила. Первое: кликать можно только видимое — если элемент спрятан под оверлеем загрузки или в неоткрытой вкладке, клик не дойдёт. Второе: клик идёт по первому узлу результата — селектор должен однозначно указывать на кнопку, а не на коллекцию из десяти подходящих элементов. Для двойных кликов и других жестов есть отдельные действия, о них ниже.

chromedp.SendKeys синтезирует клавиатуру: для каждого символа строки браузеру уходят события нажатия, ввода символа и отпускания клавиши — тот же поток, что идёт от настоящей клавиатуры. Перед вводом chromedp фокусирует поле. Строка передаётся целиком, включая управляющие символы: Enter, стрелки и забой едут тем же посимвольным конвейером, отдельное действие для них не нужно; событие ввода символа синтезируется только для печатных знаков, остальные уходят как чистые нажатия клавиш. Из этой механики следует главное свойство SendKeys, о котором ломаются половины скриптов: действие не очищает поле. Печать идёт в текущее значение — как у человека, который добавляет слова в уже набранный текст. Если в поле что-то было, вы получите склейку. Отсюда же и достоинство: для сайтов, которые валидируют каждый символ, показывают подсказки по мере ввода или включают кнопку только после «настоящего» набора, SendKeys — единственный способ пройти их корректно. Особый случай — загрузка файлов: если селектор указывает на input типа file, chromedp не печатает путь, а заполняет поле загрузки по-настоящему, через отдельный механизм браузера. Про формы целиком — валидации, дропдауны, чекбоксы — будет отдельный урок про формы, здесь фундамент.

Второй способ положить значение в поле — chromedp.SetValue: он ставит свойство value напрямую через JavaScript и затем возбуждает события input и change, чтобы фреймворки заметили изменение. Это быстрее посимвольного набора и гарантированно чистит поле: значение присваивается, а не допечатывается. Для десятков полей в формах экономия ощутимая. Но у скорости есть граница, и важно понимать, где она проходит: SetValue возбуждает события изменения, но не события клавиатуры — keydown и keyup не происходят, потому что клавиатуры не было. Для подавляющего большинства полей этого хватает: их состояние живёт на событиях input или change, и фреймворк видит значение — React и Vue слушают именно input, поэтому их состояние обновляется, и SetValue остаётся полноценным вводом для современных витрин, а не грязным хаком. Но если сайт повесил логику именно на нажатия клавиш — маски ввода, фильтрация символов, подсчёт по keyup —SetValue обойдёт эту логику стороной, и поле будет заполнено, а сайт о нём не узнает. Правило выбора звучит так: SetValue — когда нужно просто положить значение и сайт слушает изменения; SendKeys — когда важно само поведение набора. Спорные случаи решаются проверкой результата через чтение значения обратно.

Кнопка редко бывает концом сценария: за ней открывается страница результатов, вкладка, модальное окно. И здесь управление встречается с материалом прошлого урока — ожиданиями, потому что после Click начинается самая интересная гонка. События клика ушли, сайт начал реагировать: где-то поехал переход, где-то подтянулись результаты, и всё это занимает неопределённое время. Если следующее действие — чтение результатов — запустить сразу, оно попадёт в старую страницу и упадёт или прочитает мусор. Хорошая новость: chromedp сам закрывает большую часть дыры — Query-действия переспрашивают документ, и WaitVisible на целевом узле дожидается его появления, пусть даже после перехода. Остаток дисциплины — за вами: цель ожидания должна быть узлом новой страницы, а не чем-то, что совпадает и там, и там; заголовок старой страницы виден и до клика, ожидание пройдёт мгновенно и не докажет ничего. Поэтому в цепочках ждут уникальный для результата элемент: блок результатов, кнопку выхода из профиля, номер страницы. Отдельный случай — кнопка, которая отправляет форму синхронно: страница перезагружается целиком, и все ожидания начинаются заново, как после Navigate, — механика та же, поэтому и приём не меняется. Тонкие случаи, когда узлов два и оба «правильные», — территория умных ожиданий.

Одиночный клик — база, но не вся геометрия действий. DoubleClick посылает двойное нажатие той же механикой и нужен для интерфейсов, где одиночный клик выделения, а двойной открывает: файловые списки, таблицы с редактированием. chromedp.Submit отправляет родительскую форму найденного элемента — это замена нажатия Enter в поле: полезно, когда кнопка отправки не имеет устойчивого селектора, а форма одна. Для загрузки файлов существует SetUploadFiles — он принимает список путей и заполняет поле input типа file напрямую; SendKeys на таком поле тоже сработает, но явное действие читается лучше. Остальная геометрия — наведение, зажатие кнопки, перетаскивание — уже территория низкоуровневых событий мыши с координатами, и до неё дотягиваются в редких задачах; в курсе она не понадобится вплоть до итогового проекта. Все жесты, как и одиночный клик, применяются к первому узлу результата и добавляют NodeVisible по умолчанию: правила одной механики действуют без исключений, и селектор по-прежнему половина дела. Если сценарий разросся до десятков жестов, честный вопрос — не «какой ещё вызов добавить», а «не проще ли найти API», о котором говорили в первом уроке.