Первый вызов в любой работе с Browser API. Открывает страницу в живой вкладке, заводит сессию и возвращает её идентификатор вместе с тем, что заказано в include. Что при этом происходит внутри — на странице Инициализация. Цена: 3 кредита. Надстройка html считается отдельно, по прайсу Fetch.

Запрос

Параметры

string
required
Адрес страницы. Должен начинаться с http:// или https:// — иначе приходит invalid_request с кодом 400, ещё до похода в браузер.
string
default:"buttons,fields"
Что вернуть, через запятую: buttons, fields, text, html. Неизвестные значения молча отбрасываются. Подробно — в разделе Элементы и ссылки.
integer
Потолок ожидания догрузки, в миллисекундах, до 60000. По умолчанию — общий потолок службы. Поднимать его стоит там, где содержимое приезжает сторонним виджетом и стандартного ожидания ему не хватает. Помните, что сессия живёт 120 секунд всего: ожидание тратит её же.
string
CSS-селектор блока, которого ждём, — вместо общей тишины на странице. Удобно, когда точно известно, что должно появиться: форма записи, карточка товара, таблица. Не появился за отведённое время — об этом прямо сказано в reason, а собранное всё равно придёт.
string
default:"desktop"
desktop или mobile. Меняет размер экрана и User-Agent: мобильная вёрстка у многих сайтов отличается не только видом, но и составом кнопок.
string
default:"us"
Страна выхода. От неё зависит, через какой адрес пойдёт браузер.
string
default:"en"
Язык интерфейса страницы: заголовок Accept-Language и язык браузера.

Ответ

string
Идентификатор сессии. Нужен во всех последующих вызовах. Сохраните его сразу: другого способа вернуться к этой вкладке нет.
string
Адрес после всех переадресаций. Сравните с тем, что просили, если важно знать, что вас увели.
string
Устройство, которое в итоге эмулируется.
integer
Сколько шагов сделано в этой сессии. После open — единица.
integer
Секунд простоя до закрытия. Обнуляется каждым новым шагом.
integer
Секунд до общего потолка жизни сессии. Не обнуляется ничем — см. Сроки жизни.
object
Чем кончилось ожидание догрузки. Разбор — на странице Догрузка страницы.
array
Кнопки и поля со ссылками ref. Приходит, если в include заказаны buttons или fields.
integer
Сколько элементов в списке. Удобно проверять, не пуст ли он, не разбирая массив.
integer
Сколько списано за этот вызов.
Если open ответил ошибкой, сессии не осталось: она закрывается на месте, и закрывать её вам нечем — идентификатора в отказе нет. Просто повторите вызов.

Дальше

Элементы и ссылки

Что пришло в elements и как этим пользоваться.

click

Первое действие в открытой сессии.