Перечитывает страницу в открытой сессии, ничего на ней не нажимая. Возвращает то же, что open: список элементов, текст, разметку — по заказу. Цена: 1 кредит, как обычный шаг.

Зачем это нужно

Бывает, что первый ответ приходит пустым: elements_count: 0, text: "". Это не всегда значит, что на странице ничего нет. Чаще значит, что сайт отдал каркас, а содержимое приезжает сторонним виджетом — записью, картой, каталогом, — и к моменту сборки оно ещё не поднялось. Раньше такая сессия была тупиком: нажимать не на что, потому что ссылок ref нет, а запросить список заново нечем. Единственным выходом оставался новый open — то есть новая сессия, новый профиль и те же секунды ожидания сначала. Теперь можно просто перечитать. Вкладка та же, куки те же, виджет за это время успел подняться.
Вместе с wait_for это читается как «дождись вот этого блока и покажи, что вышло»: {"session_id": "…", "wait_for": ".booking-form", "wait_ms": 30000}.

Запрос

Параметры

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.
Перечитывание не воскрешает закрытую сессию. Если простой или потолок жизни уже вышли, придёт session_not_found — открывайте новую.

Когда лучше открыть заново

Перечитывать имеет смысл, пока жива та же страница. Если после open прошло больше минуты и виджет так и не поднялся, дешевле закрыть сессию и открыть страницу заново с бо́льшим wait_ms — второй заход часто попадает в уже прогретый кеш профиля.