ref. Полей больше одного — берите
form: он делает то же самое за один шаг и один кредит.
Что именно делать, решает вид поля (field в списке
элементов): в строку и textarea вводится текст —
посимвольно, как с клавиатуры, а не вставкой целиком; в select
выбирается пункт по подписи; переключатель нажимается.
Цена: 1 кредит за действие.
Запрос
Параметры
string
required
Идентификатор сессии из
open.string
required
Ссылка на поле из последнего списка
elements. У поля kind равен field.string
required
Что ввести, что выбрать или чем переключить — по виду поля:
Не длиннее 2000 знаков — иначе запрос отклоняется проверкой, ещё до похода в
браузер.
string
default:"buttons,fields"
Что вернуть после ввода. Те же значения, что и в
open.Ответ
integer
Сколько знаков отправлено в поле.
string
Что в поле оказалось на самом деле. Может отличаться от отправленного:
маска ввода,
maxlength или обработчик на странице могли его изменить.
Сверяйте — по этому полю видно, приняла форма ввод или переписала его
по-своему.object
Догрузилась ли страница после ввода. Многие формы проверяют поле на лету и
дорисовывают подсказку — это тоже изменение страницы.
Почему посимвольно
Вставки целиком в API нет намеренно. Если бы она была, ей пользовались бы по умолчанию — и упирались бы в проверку на тех самых сайтах, ради которых Browser API и нужен.Заполнение формы целиком
Отдельными вызовамиfill анкета из шести полей — это шесть обращений, шесть
ответов со всей страницей и пять пауз между ними. Для этого есть
form: поля идут подряд, по порядку, страница собирается один
раз, и кнопка отправки нажимается тем же шагом.
ref кнопки отправки из последнего ответа: пока вы заполняли поля,
форма могла перерисоваться и разблокировать её.
Частые отказы
Полный список — на странице Ошибки.

