Как повторить задания Cloud Browser без дублирования сеансов
TL;DR
Сохраните намерение создания с UUIDv4 requestId и его точной нагрузкой перед отправкой первого запроса на создание.
В случае повторяемой ошибки создания сохраняйте оригинальный идентификатор, тело и рабочее пространство, применяя ограниченное время ожидания.
Если идентификатор сеанса известен, проверьте этот сеанс, а не создавайте второй.
Идемпотентность создания защищает жизненный цикл браузера. Форме веб-сайта или покупке требуется свой собственный документированный результат и правило согласования.
Держите нерешенные попытки на виду у оператора и учитывайте разумные подсказки для повторной попытки, когда это возможно.
Подтвердите, что оригинальный сеанс завершен, прежде чем считать его очистку завершенной.
Почему повторные попытки автоматизации браузера создают дублирующие сеансы?
Повторные попытки автоматизации браузера создают дублирующие сеансы, когда вызывающий ошибочно принимает потерянный ответ за запрос, который никогда не был доставлен. Служба могла начать браузер, даже если рабочий процесс завершился до сохранения ответа. Повторная попытка с новым идентификатором запроса может затем создать другой браузер для той же задачи. Работа должна сначала восстановить оригинальное намерение. Nstdata Cloud Browser.
Сравните три таймаута. Запрос на создание может завершиться тайм-аутом до возврата идентификатора сеанса. Соединение может прервано после того, как существующий сеанс станет готов. Действие на веб-сайте может завершиться тайм-аутом после отправки формы. Эти события включают разные предшествующие эффекты. Каждое требует долговременной ссылки и правила для определения, безопасно ли продолжать. См. руководство по жизненному циклу сеанса Cloud Browser.
Какие операции можно безопасно повторять?
Повторите операцию, когда у вас есть стабильный способ идентифицировать предполагаемый эффект и достаточные доказательства того, что её повторение допустимо. Руководство Nstdata по Cloud Browser инструктирует вызывающих сохранять тот же и идентичные параметры создания для повторной попытки того же намерения создания. Используйте новый идентификатор для преднамеренной новой сессии или изменённой конфигурации. Семантика HTTP-методов сама по себе не предоставляет вашему приложению разрешения на повторное выполнение записи. .
Повторная попытка того же намерения создания в рамках политики
Сессия известна, но не готова
Оригинальный идентификатор сеанса
Опрос того же состояния в рамках срока
CDP отключен
Оригинальная готовая сессия
Выдайте новые учётные данные автоматизации и повторно подключите
Неясный результат записи веб-сайта
Чек приложения или бизнес-ссылка
Проверьте долговременное состояние, прежде чем повторять что-либо
Неясное состояние остановки
Оригинальный идентификатор сеанса
Проверьте состояние и завершите очистку
Рабочий процесс завершился аварийно
Долговременная запись владельца и сохранённые идентификаторы
Устраните расхождение оригинальной работы перед началом новой
Путь перезапуска должен восстановить состояние из долговременного хранилища. Случайный идентификатор, хранящийся в памяти, работает только до завершения текущего процесса. Сохраните намерение работы и намерение создания браузера перед отправкой запроса. Привяжите оба к области рабочего пространства. Для объяснения подключения к уже работающему браузеру см. Playwright CDP connection.
Как вы реализуете идемпотентную повторную попытку создания?
Сохраните байты запроса, повторяйте только чётко определённые временные результаты и сохраните возвращённый идентификатор сеанса перед продолжением операций на странице. Пример приближает счастливый путь к пути восстановления. Он использует текущие конечные точки Nstdata и небольшую настраиваемую политику приложения. Учебник API автоматизации браузера.
Шаг 1. Определите разрешённые параметры сеанса
Читать GET /api/v1/cloud-browser/sessions/options в запланированном рабочем пространстве. Выберите допустимые значения классов ресурсов и прокси, а также разрешённую продолжительность. Постройте тело создания в соответствии с текущей схемой. UUIDv4 requestId должен быть стабильным для этого намерения. Ответ на создание может содержать предупреждения о конфигурации, поэтому проверьте фактические настройки, прежде чем полагаться на сеанс для теста, чувствительного к окружению.
Шаг 2. Сохраните намеренный запрос перед отправкой
Запишите сериализованное тело создания в защищённую запись работы или файл, такой как request.json для примера. Сохраните оригинальное тело при перезапуске рабочих процессов. Привяжите запись к правильному рабочему пространству и используйте ограничение базы данных или аренду, чтобы избежать одновременных владельцев, конкурирующих за работу. Храните только одобренные настройки эксперимента. Пользовательский URL прокси может содержать учётные данные, поэтому используйте соответствующее безопасное хранилище, если ваше приложение выбирает этот путь.
Шаг 3. Запустите ограниченный рабочий процесс повторной попытки
Используйте Node.js 22.12 или более позднюю версию. Сохраните retry.mjs и retry-demo.mjs, установите NSTDATA_API_KEY и любые применимые NSTDATA_TEAM_ID, и выполните node retry-demo.mjs request.json. Эта управляемая ветка требует вашего авторизованного рабочего пространства Cloud Browser. Функция повторной попытки была протестирована с синтетическим переносом, который теряет первый ответ, возвращает сессию во втором, и сравнивает два тела байт за байтом.
import{ setTimeout as wait }from'node:timers/promises';exportasyncfunctionresumeCreate(bodyBytes, send, delay = wait){const intended =JSON.parse(bodyBytes);if(!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(intended.requestId)){thrownewError('Expected a saved UUIDv4 requestId');}for(let attempt =0; attempt <3; attempt++){let response;try{ response =awaitsend(bodyBytes);}catch{if(attempt ===2)break;awaitdelay(500*2** attempt);continue;}if(!response.ok){const retryable =[429,503].includes(response.status);if(!retryable)thrownewError('Inspect create HTTP '+ response.status);if(attempt ===2)break;const header = response.headers.get('retry-after');const hint = header &&/^\d+$/.test(header)?Number(header)*1000: header ?Math.max(0,Date.parse(header)-Date.now()):0;if(hint >10_000)break;// Leave the saved intent for a later worker.awaitdelay(Math.max(500*2** attempt, hint ||0));continue;}const result =await response.json().catch(()=>null);if(result?.err !==true&& result?.success !==false&&typeof result?.data?.sessionId ==='string'&& result.data.sessionId){return result.data.sessionId;}break;}thrownewError('Create outcome unresolved. Retain the original requestId and payload.');}
Пример повторяет сбой передачи, HTTP 429 или HTTP 503 в рамках своей ограниченной политики. Он ждет по крайней мере доступный подсказку Retry-After, если эта подсказка укладывается в бюджет работника. Если служба требует более длительного ожидания, работник оставляет оригинальный замысел в ожидании для другой разрешенной попытки. Для производства распределите клиентов с джиттером и обеспечьте емкость очереди. Руководство MDN для клиентов с ограниченной частотой.
Шаг 4. Устранение ошибок, которые требуют принятия решения
Рассматривайте ошибки проверки и авторизации как проблемы конфигурации. При HTTP 400 проверьте недействительное поле с текущими опциями и создайте новый замысел, если исправленные настройки отличаются. При 401, 403 или 470 проверьте тип ключа и выбор команды. При 409 проверьте оригинальную операцию и состояние сессии, если это возможно. Сохраните результат и оставьте защищенный запрос нетронутым, если результат остается неясным.
Шаг 5. Подтвердите готовность браузера и бизнес-результат
Сохраните sessionId и проверьте оригинальную сессию. Запрашивайте учетные данные автоматизации только тогда, когда сессия готова. Перед выполнением действия проверьте личность страницы, предполагаемое происхождение и текущее состояние приложения. Если работник возобновляется после разъединения, проверьте, было ли ранее действие веб-сайта уже выполнено. Руководство по отладке браузера в реальном времени объясняет, как проверить страницу и контекст запроса.
Шаг 6. Устранение отключения
Остановите оригинальную сессию и проверьте ее до состояния ended, или следуйте вашей политике тайм-аута и передачи управления. Отключенный клиент и успешная задача отделены от остановленного управляемого браузера. Если контроллер аварийно завершил работу только с записанным идентификатором запроса, исследуйте то первоначальное создание, прежде чем предполагать, что оно никогда не выполнялось.
Как вы должны тестировать восстановление задания браузера?
Симулируйте неопределенный результат создания и убедитесь, что перезапущенный работник читает те же байты перед повторной отправкой. После успешного синтетического ответа убедитесь, что его ID сохранен для соответствующей бизнес-задачи. Смоделируйте постоянную ошибку и подтвердите, что работник останавливается после первого ответа. Смоделируйте ограничение по количеству запросов и проверьте выбранную задержку. Эти тесты измеряют поведение запроса и планировщика, не тратя время выполнения браузера.
Тестируйте действие приложения отдельно. В авторизованной среде staging создайте запись с синтетической ссылкой, прервите клиента после клика и подтвердите, что восстановление может найти квитанцию без необходимости еще одной успешной записи. Затем симулируйте операцию, которая никогда не достигла бэкэнда, и проверьте согласованную политику повторных попыток. Повторные попытки теста Playwright могут повторно запустить тело теста, что имеет значение, когда тест создает состояние. Руководство по повторным попыткам Playwright.
Как несколько работников делят политику восстановления?
Несколько работников могут делить политику восстановления, заявив о одной долговечной задаче перед тем, как действовать на ее намерение создания. Один владелец читает или записывает намерение и фиксирует возвращаемый идентификатор сессии. Поздний владелец проверяет предыдущий прогресс перед созданием чего-либо. Предложение заявки к базе данных или аренда долговой очереди могут сериализовать это решение. Примерный файл представляет одно сохраненное намерение и не обеспечивает параллельное планирование.
Для теста перезапуска в staged прервите работника после начала его вызова создания, запустите нового работника для той же записи и сравните, что он отправляет. Сохраните оригинальную идентичность задачи и подтвердите, что очистка использует возвращенную сессию. Если определенный результат ресурса недоступен, отметьте задачу для сверки, а не позволяйте бесконечному циклу задач замены.
Как браузер Nstdata Cloud вписывается в этот дизайн восстановления?
Браузер Nstdata Cloud предоставляет управляемые облачные браузеры для автоматизации браузера и ИИ-агентов. Его конечные точки жизненного цикла предоставляют работнику путь для инспекции браузера, который он создал, и восстановления после перерыва. Встроенные прокси-опции принадлежат сохраненной конфигурации сессии, поэтому повторная попытка сохраняет выбор исходящего трафика для того же намерения. Живой просмотр помогает авторизованным операторам исследовать, когда работник не может принять решение из структурированного состояния. Приложение остается ответственным за долговое владение и проверку бизнес-действия.
Идентичность создания. Сохраните документированный ID запроса и полезную нагрузку для того же предполагаемого создания.
Явное состояние сессии. Проверяйте готовность, сохраняйте известный ID сессии и требуйте отдельного подтверждения завершения.
Видимость для оператора. Изучите оригинальное состояние, когда диагностика требует наблюдения за управляемой страницей или проверки доступных логов.
Сверка использования. Соединяйте принятые и неудачные запуски с наблюдаемым временем выполнения и трафиком. Цены на Cloud Browser.
Что должно содержать руководство по восстановлению?
Запишите ID задачи, рабочую область, оригинальный ID запроса, известный ID сессии, последний завершенный этап, безопасный код состояния и следующее действие по сверке. Сохраните необработанную защищенную запись создания в долговом хранилище и удалите учетные данные доступа из операционного вывода. Отслеживайте неразрешенные отправления и неподтвержденные остановки, чтобы следующий владелец знал, с чего начать. Протестируйте восстановление с одной намеренно прерванной ошибкой перед добавлением незаметных повторных попыток.
Q: Должен ли каждый повтор использовать новый ID запроса?
Повторно используйте оригинальный ID и идентичную полезную нагрузку создания для того же намерения создания. Генерируйте новый ID, когда вы намеренно начинаете другую сессию или меняете конфигурацию.
Q: Доказательство неудачного HTTP-запроса означает, что браузер не был создан?
Ошибка передачи может оставить результат неопределенным. Согласуйте сохраненное намерение создания перед началом другой задачи.
Q: Предотвращает ли идемпотентность жизненного цикла браузера дублирование отправок на сайт?
Действие на сайте нуждается в своей постоянной ссылке и проверке результата. Подтвердите бизнес-состояние перед любой повторной попыткой.
Q: Могу ли я переподключиться, когда браузер уже завершился?
Проверьте оригинальную сессию. Завершенный браузер требует преднамеренной новой сессии, если рабочий процесс должен запуститься снова.
Q: Что делать, если запрос на остановку истекает?
Проверьте оригинальный идентификатор сессии. Держите очистку в ожидании, пока не будет подтверждено терминальное состояние.
Создайте тестовые случаи, которые изолируют маршрутизацию и настройки браузера. Используйте сигналы браузера и видимые результаты приложения, чтобы объяснить различия в локали в сеансе облачного браузера.
Marcus Chen
Nov. 19th 2026
Запускайте облачные браузеры по запросу
Работайте с отпечатками браузера и CAPTCHA
Автоматизируйте процессы и расширяйте возможности ИИ-агентов
От сбора веб-данных и тестирования до автоматизации с ИИ — запускайте всё в облаке.