TL;DR
- Восстановите соединение с оригинальным идентификатором браузера, когда работник теряет соединение, и провайдер все еще сообщает, что оригинальная сессия
ready. - Выдайте краткосрочные учетные данные для этой сессии, подтвердите ее личность и держите ключ бизнес API вне соединения с браузером.
- Выберите оригинальную вкладку по утвержденному URL и контрольной точке, специфичной для задачи. Рассматривайте отсутствующую или неопределенную вкладку как решение для примирения.
- Прочтите долговечный бизнес-четвертной документ перед повторной попыткой действия, ответ на которое был потерян.
- Сессия браузера с состоянием
endedтребует новой сессии, если работа может безопасно возобновляться. Восстановление браузера не может установить, что произошло в приложении. - Проверяйте принятие задания и завершение сессии независимо. Новый WebSocket и остановленный браузер подтверждают разные вещи.
Когда вы можете восстановить соединение с удаленным браузером?
Вы можете восстановить соединение с удаленным браузером, когда оригинальное время выполнения все еще доступно, и вы можете получить текущие учетные данные соединения для той же сессии. Отключение от сети сообщает вам, что наблюдал работник. Браузер все еще может иметь открытые свои страницы, и целевое приложение, возможно, уже приняло последнее действие. Nstdata документирует поток прикрепления для существующих сессий облачного браузера как часть своей службы автоматизации браузера.
Предположим, что рецензент выпуска достиг отчета о предварительном просмотре, и работник отключается сразу после нажатия на контрольный элемент одобрения. Платформа браузера может сообщить, существует ли сессия. Отчет может показать, какая ревизия на экране. Авторитетная запись приложения определяет, была ли комиссирована одобрение. Это три отдельных факта. Работник должен восстановить наблюдение, прежде чем он решит действовать.
Руководство по жизненному циклу сессии браузера охватывает создание и завершение сессий. Восстановление начинается позже, с существующей задачи и сохраненного идентификатора сессии. Руководство по повторным попыткам и идемпотентности охватывает другой случай, когда ответ на создание мог быть потерян, и работник никогда не узнал, какая сессия была выделена.
Какое состояние должен сохранить работник перед любым отключением?
Сохраните идентичности задания и сессии, ожидаемую границу страницы и контрольную точку приложения перед входом в шаг, который может изменить бизнес-состояние. Небольшая запись может содержать идентификатор задания, ярлык рабочего пространства, идентификатор сессии браузера, утвержденный источник, ожидаемый маршрут, безопасное значение контрольной точки и ссылку на операцию приложения. Держите его политику доступа отдельно от учетных данных браузера.
| Что вы восстанавливаете | Доказательства для сохранения | Решение после повторного подключения |
|---|---|---|
| Владение браузером | Идентификатор сессии, владелец задания, целевое рабочее пространство | Проверьте оригинальную сессию |
| Идентификация страницы | Утвержденный источник, ожидаемый путь, специфичная для задачи метка | Возобновите наблюдение только если страница уникальна |
| Прогресс бизнеса | Последняя зарегистрированная контрольная точка и ссылка на операцию | Прочитайте долговечный результат перед любым новым действием |
| Ответственность за очистку | Один владелец остановки и крайний срок выпуска | Держите примирение активным до подтверждения завершения |
Избегайте сохранения подписанного адреса WebSocket или токена доступа в записи задания. Храните идентификатор, использованный для запроса свежих учетных данных через поддерживаемый интерфейс. Такой подход предоставляет заменяющему работнику долговечную точку отсчета без раскрытия повторного соединения в очереди, тикете или трассировке. Смотрите руководство по жизненному циклу секретов OWASP.
Как восстановить оригинальную сессию и найти ее вкладку?
Проверьте существующую сессию, установите ограниченное соединение CDP и подтвердите точную страницу и контрольную точку перед выполнением другого действия. Рабочий процесс предполагает доступ к оригинальному рабочему пространству, записанному идентификатору сессии и безопасному представлению целевого приложения. Локальный пример использует Node.js 22, playwright-core@1.65.1 и сопутствующую фиктивную настройку. Установите Chromium с помощью npx playwright-core install chromium для локальной ветки.
Шаг 1. Прочитайте запись сессии
Откройте Cloud Browser → Session History в нужном рабочем пространстве и найдите оригинальную сессию. В коде проверьте GET /sessions/{sessionId} в соответствии с задокументированным базовым API Cloud Browser. Рассматривайте ready как разрешение на дальнейшее оформление учетных данных, при условии наличия авторизации. Если остановка уже выполняется, наблюдайте, пока платформа не стабилизируется. Если сессия ended, используйте контрольную точку приложения, чтобы решить, можно ли безопасно продолжить новую сессию. Документация по автоматизации браузера Cloud Browser.
[Скриншот: Показать тестовую сессию в истории сессий, ее состояние и соответствующую ссылку на задание. Скрыть идентификаторы аккаунта и сессии.]
Шаг 2. Получите текущие учетные данные соединения
Для готовой сессии выполните запрос POST /sessions/{sessionId}/automation-credentials с бизнес-учетными данными API и правильным контекстом рабочего пространства. Проверьте возвращаемый идентификатор сессии и срок действия. Передайте возвращенный адрес CDP и заголовок клиенту, используя задокументированное построение заголовка. Никогда не регистрируйте полный подписанный адрес или заголовок аутентификации. Используйте документацию Playwright BrowserType для параметров connectOverCDP() и ограничений протокола.
Шаг 3. Найдите оригинальную вкладку, не создавая новую
Запустите node recover.mjs с обратным LOCAL_CDP_URL и APP_ORIGIN, который предоставляет вспомогательный объект. Запустите node fixture.mjs и откройте его маршрут /recover один раз в тестовом браузере. Приложенный клиент ищет существующие контексты для единого точного совпадения, а затем считывает ожидаемый маркер фиктивного объекта. Вспомогательный проверяющий предоставляет временный профиль Chromium, проверяет, что оригинальная страница выжила после отключения клиента, и подтверждает, что две совпадающие вкладки вызывают отказ. Управляемая ветка требует авторизованного ключа Nstdata и существующей готовой сессии с эквивалентной одобренной контрольной точкой приложения. Используйте контрольную точку на этапе, доступную в авторизованной среде управляемого браузера.
const root = 'https://api.nstdata.io/api/v1/cloud-browser'; export async function api(method, path, body) { const key = process.env.NSTDATA_API_KEY; if (!key) throw new Error('Set NSTDATA_API_KEY'); const headers = { 'x-api-key': key }; if (process.env.NSTDATA_TEAM_ID) headers['x-team-id'] = process.env.NSTDATA_TEAM_ID; if (body) headers['content-type'] = 'application/json'; let response; try { response = await fetch(root + path, { method, headers, redirect: 'error', body: body ? JSON.stringify(body) : undefined, signal: AbortSignal.timeout(20_000), }); } catch { throw Object.assign(new Error('API transport failed; reconcile the original operation'), { retryable: true }); } const retryable = response.status === 429 || response.status >= 500; let result; try { result = await response.json(); } catch { throw Object.assign(new Error('Invalid API JSON'), { retryable }); } if (!response.ok || result.err === true || result.success === false) { throw Object.assign(new Error(`Cloud Browser API HTTP ${response.status}`), { retryable }); } if (!result.data) throw new Error('Missing API data'); return result.data; } export async function connection(id) { if (!id) throw new Error('Set NSTDATA_SESSION_ID'); const path = `/sessions/${encodeURIComponent(id)}`; const session = await api('GET', path); if (session.state !== 'ready') throw new Error(`Session is ${session.state}, not ready`); const c = await api('POST', path + '/automation-credentials'); if (c.sessionId !== id || !c.headerName || !c.accessToken || !(Date.parse(c.expiresAt) > Date.now()) || new URL(c.cdpUrl).protocol !== 'wss:') { throw new Error('Invalid or expired CDP credentials'); } return { endpoint: c.cdpUrl, headers: { [c.headerName]: c.headerName.toLowerCase() === 'authorization' ? `Bearer ${c.accessToken}` : c.accessToken }, }; } export async function endpoint() { // An isolated local CDP endpoint can test the client without managed credentials. if (process.env.LOCAL_CDP_URL) { const url = new URL(process.env.LOCAL_CDP_URL); if (!['127.0.0.1', 'localhost', '[::1]'].includes(url.hostname)) { throw new Error('LOCAL_CDP_URL must use loopback'); } return { endpoint: url.href, headers: {} }; } return connection(process.env.NSTDATA_SESSION_ID); }
import { chromium } from 'playwright-core'; import { endpoint } from './cloud-api.mjs'; const origin = new URL(process.env.APP_ORIGIN ?? 'http://127.0.0.1:4173'); const expected = new URL('/recover', origin).href; const credentials = await endpoint(); const browser = await chromium.connectOverCDP(credentials.endpoint, { headers: credentials.headers, timeout: 15_000, }); try { const candidates = browser.contexts().flatMap(context => context.pages()) .filter(page => page.url() === expected); if (candidates.length !== 1) throw Error('Checkpoint page must be unique'); const page = candidates[0]; const marker = page.locator('output[data-job="job-42"]'); await marker.waitFor({ state: 'visible', timeout: 5_000 }); if ((await marker.textContent()).trim() !== 'reviewed') throw Error('Unknown checkpoint'); console.log(JSON.stringify({ job: 'job-42', checkpoint: 'reviewed', next: 'reconcile' })); } finally { await browser.close(); }
Ожидаемый результат фикстуры содержит только метку безопасной задачи, наблюдаемый контрольный пункт и следующее решение. Результат преднамеренно reconcile, потому что увидеть страницу, помеченную как проверенную, не может доказать, что позже завершилась запись приложения. Когда реальный рабочий процесс обычно перемещается или открывает новую вкладку, определите точные утвержденные маршруты и маркеры для каждого перехода. Руководство Playwright по страницам и вкладкам объясняет связь между страницами и контекстами браузера.
Шаг 4. Проверьте приложение перед повторным воспроизведением записи
Ищите бизнес-накладную или статус, используя путь приложения только для чтения. Если результат уже существует для первоначальной операции, отметьте задачу как принятую на основе этих данных и запланируйте очистку. Если результат отсутствует, подтвердите, что первоначальный запрос завершен, прежде чем решать, повторить его или нет. Если целевое приложение поддерживает ключ идемпотентности, сохраните ссылку на оригинальную операцию и следуйте правилам этого приложения. Неопределенный результат направляется оператору или в очередь согласования с установленным сроком.
Что должно произойти, если шаг восстановления не удался?
Неудачный шаг восстановления должен сохранить текущее состояние и сообщить, какой уровень предотвратил проверку. Неудачный запрос сессии не может установить, существует ли браузер. Успешный WebSocket без соответствующей страницы является успехом соединения и неудачей выбора страницы. Эти состояния требуют различных следующих действий.
| Симптом | Вероятная причина для проверки | Следующее действие |
|---|---|---|
| Оригинальная сессия завершена | Время ожидания, явная остановка или результат жизненного цикла провайдера | Прочитать долговременный контрольный пункт, прежде чем выделить замену |
| Соединение отклонено | Неправильное рабочее пространство, истекшие учетные данные или неверная структура заголовка | Проанализировать первоначальное состояние и выдать текущие учетные данные после исправления конфигурации |
| Две страницы соответствуют URL | Дубликат вкладки или параллельное владение | Остановить автоматизацию и потребовать более сильный маркер задачи или явный выбор вкладки |
| Страница показывает завершенный экран без накладной | Неполное состояние или устаревший пользовательский интерфейс | Проверить запись операции на стороне приложения |
| Очистка остается в ожидании | Остановка результата не подтверждена | Держите сессию под контролем и проверьте ее конечное состояние |
Если новый рабочий процесс может начаться, пока старый все еще подключен, используйте проверку аренды приложения или прав собственности перед выдачей любой записи. Освобождайте возможности браузера только после подтверждения очистки в соответствии с жизненным циклом провайдера. Руководство по аутентификации CDP помогает изолировать сбой конфигурации, прежде чем рабочий процесс коснется страницы.
Как Nstdata Cloud Browser подходит для книги восстановлений?
Nstdata Cloud Browser предоставляет управляемые облачные браузеры для автоматизации браузера и ИИ-агентов, с состоянием сессии и документированным подключением CDP. Команда может использовать одну и ту же службу для выполнения рутинных задач и контролируемого восстановления, сохраняя при этом свои собственные контрольные точки приложения. Используйте подключение к существующей сессии, когда рабочее пространство все еще владеет готовым временем выполнения. Live View может помочь уполномоченному оператору проверить страницу, которую автоматизация не может уникально идентифицировать. Информация о сессии службы не может установить, была ли произведена предварительная проверка или другое действие приложения.
- Поиск сессии. Используйте предыдущий идентификатор для проверки состояния жизненного цикла и избегайте выделения замены при ошибке передачи.
- Краткосрочное подключение. Запрашивайте текущие учетные данные для сессии, храните их внутри рабочего процесса и сохраняйте только безопасную ссылку на операцию.
- Доказательство оператора. Используйте доступные наблюдения, чтобы понять, какая страница была активной или зависла. Держите конфиденциальные скриншоты, URL и логи вне рутинных запросов.
- Явная очистка. Назначьте контроллер, который остановит управляемый браузер. Закрытие подключения и завершение управляемой сессии являются отдельными операциями.
Что должна доказать одна тренировка восстановления?
Тренировка восстановления должна доказать, что рабочий процесс замены может найти правильную страницу, распознать неопределенное состояние бизнеса и остановить исходную сессию под известным управлением. Начните с авторизованного отчета о подготовке, отключите рабочий процесс перед контрольной точкой только для чтения и убедитесь, что замена читает тот же маркер задачи. Повторите с конкурентной вкладкой и контрольной точкой, которая не может разрешить бизнес-результат. Первый запуск должен продолжать наблюдение, в то время как другие запуски должны остановиться или эскалироваться с обоснованной причиной. Запишите время, прошедшее с момента отключения до подтвержденного состояния, и подсчитайте случаи, которые требовали вмешательства человека. Отслеживайте успешность работы и очистку браузера отдельно. Когда сбой требует судебного анализа, рассмотрите запись и воспроизведение сеанса для синтетических тестовых случаев с утвержденным сроком хранения.
FAQ
Q: Означает ли сброшенный WebSocket, что оригинальный браузер остановился? Состояние браузера определяется записями сеанса провайдера. Запросите оригинальный идентификатор перед повторным подключением или заменой браузера.
Q: Может ли завершенная сессия Cloud Browser быть повторно открыта? Смотрите на завершенную сессию как на терминальную. Используйте постоянное состояние приложения, чтобы выбрать безопасный следующий шаг в новой сессии.
Q: Должен ли работник по восстановлению создать новую страницу? Выберите существующую страницу, когда вам нужно ее состояние. Откройте новую страницу только для рабочего процесса, который явно разрешает восстановление контекста.
Q: Можно ли повторно использовать старый адрес CDP после отключения? Запросите текущие учетные данные для оригинальной готовой сессии и проверьте задокументированное время окончания. Храните только безопасную ссылку на сессию для последующего восстановления.
Q: Что должен увидеть оператор при эскалации? Предоставьте идентификатор задания, безопасную фазу, состояние браузера, доказательства результата и владельца очистки. Делитесь защищенными артефактами через утвержденный канал инцидентов.





