Заполняет одно поле по его 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
Догрузилась ли страница после ввода. Многие формы проверяют поле на лету и дорисовывают подсказку — это тоже изменение страницы.

Почему посимвольно

Вставка отличается от живого ввода тем, что поле получает одно событие вместо потока нажатий. Защита это видит и отличает автоматизацию от человека именно по такому следу.Отсюда следствие: длинное значение занимает время. Символы идут с разбросом задержки 10–30 мс, то есть сотня символов — около двух секунд.
Вставки целиком в API нет намеренно. Если бы она была, ей пользовались бы по умолчанию — и упирались бы в проверку на тех самых сайтах, ради которых Browser API и нужен.

Заполнение формы целиком

Отдельными вызовами fill анкета из шести полей — это шесть обращений, шесть ответов со всей страницей и пять пауз между ними. Для этого есть form: поля идут подряд, по порядку, страница собирается один раз, и кнопка отправки нажимается тем же шагом.
Берите ref кнопки отправки из последнего ответа: пока вы заполняли поля, форма могла перерисоваться и разблокировать её.

Частые отказы

Полный список — на странице Ошибки.