open: список элементов, текст, разметку — по заказу.
Цена: 1 кредит, как обычный шаг.
Зачем это нужно
Бывает, что первый ответ приходит пустым:elements_count: 0, text: "". Это не
всегда значит, что на странице ничего нет. Чаще значит, что сайт отдал каркас, а
содержимое приезжает сторонним виджетом — записью, картой, каталогом, — и к
моменту сборки оно ещё не поднялось.
Раньше такая сессия была тупиком: нажимать не на что, потому что ссылок ref
нет, а запросить список заново нечем. Единственным выходом оставался новый
open — то есть новая сессия, новый профиль и те же секунды ожидания сначала.
Теперь можно просто перечитать. Вкладка та же, куки те же, виджет за это время
успел подняться.
Запрос
Параметры
string
required
Идентификатор сессии из
open.string
default:"buttons,fields"
Что вернуть. Те же значения, что и в
open.integer
Потолок ожидания догрузки на этом шаге, в миллисекундах, до 60000. По
умолчанию — общий потолок службы.
string
CSS-селектор блока, которого ждём. Пока он не появится, ожидание не кончится —
либо кончится по потолку, и тогда в
reason будет прямо сказано, что блок так
и не пришёл.Ответ
Тот же, что уopen, минус session_id — он у вас и так есть: url, steps,
idle_left, life_left, settled, elements, elements_count, credits.
Когда лучше открыть заново
Перечитывать имеет смысл, пока жива та же страница. Если послеopen прошло
больше минуты и виджет так и не поднялся, дешевле закрыть сессию и открыть
страницу заново с бо́льшим wait_ms — второй заход часто попадает в уже прогретый
кеш профиля.
