Как обрабатывать всплывающие окна и новые вкладки в Playwright
TL;DR
Используйте событие popup страницы-открывателя, когда известное действие создает дочернюю вкладку или окно.
Используйте событие page контекста браузера, когда создатель неизвестен или вы намеренно отслеживаете все новые страницы в этом контексте.
Зарегистрируйте обещание события перед кликом и установите, как долго клиент будет ждать.
Проверьте назначение и специализированный маркер задачи перед взаимодействием с новой страницей.
Используйте ожидание навигации для пути в одной вкладке и обработчик диалоговых окон для JavaScript-диалогов.
Закрывайте только страницы, принадлежащие задаче, затем проверьте очистку управляемой сессии через контроллер.
Как вы обрабатываете всплывающее окно или новую вкладку в Playwright?
Обрабатывайте всплывающее окно, ожидая события от страницы, которая его откроет, а затем рассматривайте возвращаемую страницу как отдельную цель автоматизации. Проверьте ее фактическое назначение и ожидаемое состояние приложения перед выполнением другого действия. Nstdata предоставляет управляемые браузеры, к которым поддерживаемый клиент Playwright может подключаться и управлять несколькими страницами.
Рассмотрим очередь просмотра на стадии ревью с ссылкой, которая открывает предварительный просмотр релиза. Несвязанная вкладка статуса также открыта. Выбор самого последнего элемента в context.pages() предполагает, что никакой другой рабочий или страница не создала вкладку. Более безопасный дизайн ожидает события от известного открывателя и проверяет, чтобы возвращаемая страница отображала правильный релиз. Для случаев, когда кто-то сначала вручную открывает страницу, смотрите рабочий процесс передачи оператору.
Какое событие соответствует поведению вашего приложения?
Выберите событие, которое соответствует тому, что на самом деле создает страница. Новый модальный элемент DOM сохраняет ту же страницу Playwright и нуждается в обычных локаторах. Диалог, вызванный JavaScript, является отдельным событием. Новая вкладка представлена другой страницей, а навигация в одной вкладке изменяет URL-адрес оригинальной страницы.
Правильный дочерний URL, ожидаемый маркер и открыватель, если применимо
Контекст получает страницу из неизвестного источника
context.waitForEvent('page')
Разрешенное назначение, идентичность задачи и право собственности на страницу
Навигация в одной вкладке
page.waitForURL()
Ожидаемый конечный маршрут и видимая цель
DOM-модальный элемент на оригинальной странице
Найдите модальный элемент или диалог, отображаемый приложением
Правильная доступная область и предполагаемые элементы управления
JavaScript-диалог
page.on('dialog', ...) когда требуется обработка
Авторизованная обработка и ожидаемый эффект приложения
Документация Playwright о нескольких страницах описывает связь между событием на уровне контекста и событием всплывающего окна на уровне открывателя. Руководство Playwright по диалогам охватывает другую поверхность. Определите, какое поведение использует управляемое приложение, прежде чем выбрать событие.
Как вы захватываете предполагаемый предварительный просмотр релиза?
Захватите всплывающее окно с известной страницы ревью и требуйте точный URL-адрес фикстуры и идентификатор релиза. В примере используется локальная фикстура для стадии и дополнительная вкладка для захвата распространенной ошибки. Он работает на Node.js 22 и playwright-core@1.65.1. Используйте сопроводительный fixture.mjs и установите локальный Chromium с помощью npx playwright-core install chromium для автономного пути.
Шаг 1. Подготовьте открыватель и ожидаемую дочернюю страницу
Запустите node fixture.mjs. Утвержденный открыватель — это /opener, а ожидаемая дочерняя страница — это /child. Дочерняя страница отображает заголовок Предварительный просмотр релиза и маркер для fixture-42. Скрипт также создает ложную вкладку для /status. В реальном приложении извлекайте утвержденное назначение и маркер из авторизованного рабочего элемента перед началом клика.
Шаг 2. Подключите рабочий элемент к правильному браузеру
Сохраните общие модули и выберите локальный запуск или путь проверки обратной связи CDP. Если вы используете управляемый браузер, используйте готовую сессию и соответствующую утвержденную цель, которая доступна из этой среды. Настройте NSTDATA_API_KEY, NSTDATA_SESSION_ID и выбор рабочего пространства по желанию. Рабочий процесс был протестирован на локальном Chromium и обратной связи CDP. Он требует авторизованного рабочего пространства для тестирования управляемой ветки. Руководство по автоматизации браузера Nstdata.
const root ='https://api.nstdata.io/api/v1/cloud-browser';exportasyncfunctionapi(method, path, body){const key = process.env.NSTDATA_API_KEY;if(!key)thrownewError('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 =awaitfetch(root + path,{ method, headers,redirect:'error',body: body ?JSON.stringify(body):undefined,signal:AbortSignal.timeout(20_000),});}catch{throwObject.assign(newError('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{throwObject.assign(newError('Invalid API JSON'),{ retryable });}if(!response.ok|| result.err===true|| result.success===false){throwObject.assign(newError(`Cloud Browser API HTTP ${response.status}`),{ retryable });}if(!result.data)thrownewError('Missing API data');return result.data;}exportasyncfunctionconnection(id){if(!id)thrownewError('Set NSTDATA_SESSION_ID');const path =`/sessions/${encodeURIComponent(id)}`;const session =awaitapi('GET', path);if(session.state!=='ready')thrownewError(`Session is ${session.state}, not ready`);const c =awaitapi('POST', path +'/automation-credentials');if(c.sessionId!== id ||!c.headerName||!c.accessToken||!(Date.parse(c.expiresAt)>Date.now())||newURL(c.cdpUrl).protocol!=='wss:'){thrownewError('Invalid or expired CDP credentials');}return{endpoint: c.cdpUrl,headers:{[c.headerName]: c.headerName.toLowerCase()==='authorization'?`Bearer ${c.accessToken}`: c.accessToken},};}exportasyncfunctionendpoint(){// An isolated local CDP endpoint can test the client without managed credentials.if(process.env.LOCAL_CDP_URL){const url =newURL(process.env.LOCAL_CDP_URL);if(!['127.0.0.1','localhost','[::1]'].includes(url.hostname)){thrownewError('LOCAL_CDP_URL must use loopback');}return{endpoint: url.href,headers:{}};}returnconnection(process.env.NSTDATA_SESSION_ID);}
import{ chromium }from'playwright-core';import{ endpoint }from'./cloud-api.mjs';exportasyncfunctionwithPage(task){const origin =newURL(process.env.APP_ORIGIN??'http://127.0.0.1:4173');const remote =Boolean(process.env.LOCAL_CDP_URL|| process.env.NSTDATA_SESSION_ID);if(!remote && origin.hostname!=='127.0.0.1')throwError('Use the local fixture for local runs');const connection = remote ?awaitendpoint():null;const browser = connection
?await chromium.connectOverCDP(connection.endpoint,{headers: connection.headers,timeout:15_000}):await chromium.launch({args:['--no-proxy-server']});let page;try{const context = remote ? browser.contexts()[0]:await browser.newContext();if(!context)throwError('Expected a browser context'); page =await context.newPage(); page.setDefaultTimeout(8_000); page.setDefaultNavigationTimeout(10_000);returnawaittask(page, origin);}finally{try{await page?.close();}finally{await browser.close();}}}
Шаг 3. Зарегистрировать событие и кликнуть
Сохраните пример как popup.mjs, затем выполните node popup.mjs. Обещание события регистрируется перед кликом по ссылке. Возвращенное всплывающее окно сохраняется в отдельной переменной. Скрипт проверяет его маршрут и то, что его содержимое относится к ожидаемому тестовому выпуску. Он также доказывает, что родительское окно не сменило навигацию и что всплывающее окно принадлежит этой странице. Справка по Playwright Page API документирует семантику всплывающих окон и родительских.
Шаг 4. Завершите дочерний рабочий процесс под известным владением
Закройте ребенка и приманку, созданные по примеру. Если другая работа владеет вкладками в этом времени выполнения, оставьте эти вкладки в покое. Запишите, с какой страницы пришел результат. Остановите управляемую сессию только тогда, когда контроллер подтвердит, что вся авторизованная работа завершена. Руководство по управлению сеансами браузера показывает, где происходит завершение.
[Скриншот: Показать страницу предварительного просмотра и подтвержденный предварительный просмотр ребенка с синтетическим идентификатором релиза. Сохраните другие вкладки и подписанные адреса вне скриншота.]
Почему тайм-аут ожидания всплывающего окна или выбор неправильной вкладки?
Тайм-аут ожидания всплывающего окна обычно завершится ошибкой, потому что слушатель запоздал, открыватель неправильный, приложение навигировало в той же вкладке или ожидаемое содержимое никогда не пришло. Узнайте, какой этап произошел. Проверьте задокументированное поведение кнопки и подпишитесь на соответствующей странице. Вкладка может появиться до того, как ее окончательный URL или содержимое будет готово, поэтому подтвердите оба независимо.
Симптом
Вероятное объяснение
Как восстановиться
Событие истекает, но URL изменился
Исходная страница навигировала
Подождите известного пункта назначения в той же вкладке, затем проверьте содержимое
Ограничьте ожидание открывателем или сопоставьте возвращаемую страницу перед действием
Новая вкладка открывается с пустой страницей
Целевая навигация ожидается или не удалась
Дождитесь утвержденного маршрута и результата с ограниченным тайм-аутом
Всплывающее окно закрывается до следующего шага
Приложение завершило или отклонило рабочий процесс
Прочитайте родительский или серверный чек перед повторной попыткой
Неожиданное назначение или дополнительная вкладка
Рабочий процесс отличается от утвержденного шаблона
Остановите это действие и проведите расследование с безопасным идентификатором страницы
Если новая страница является частью чувствительного рабочего процесса, держите ее полный URL вне логов и избегайте записи частных вкладок по умолчанию. Руководство по отладке консоли и сети помогает определить, какая страница и маршрут фактически вызвали сбой.
Как обработать рабочий процесс, который иногда остается в одной вкладке?
Обрабатывайте необязательную навигацию, определяя два ожидаемых результата и добавляя ограниченное наблюдение для каждого. Приложение может открыть предварительный просмотр в новой вкладке только для определенных ролей аккаунта. Измерьте фактическое поведение в утвержденной тестовой среде и держите контракт видимым в ваших случаях. Конфигурация, которая всегда использует всплывающее окно, все равно должна терпеть неудачу, если она молча переходит к родителю.
Для действительных альтернатив начинайте соответствующие ожидания перед кликом и держите любые слушатели в рамках этого действия. Когда один результат установлен, отмените или закройте неиспользуемое наблюдение аккуратно, чтобы оно не повлияло на следующий шаг. Подтвердите цель отдельно от типа перехода. Сопоставьте ожидаемое происхождение и предполагаемую ревизию по обоим маршрутам и сохраняйте доказательства, которые показывают, какой маршрут прошел.
Как Nstdata Cloud Browser поддерживает рабочие процессы с несколькими страницами?
Nstdata Cloud Browser предоставляет управляемые облачные браузеры для автоматизации браузера и ИИ-агентов. Используйте CDP, чтобы подключиться к выбранной сессии и выяснить владение страницей от приложения и клиента. Live View дает уполномоченному оператору возможность просмотреть активную страницу, когда поток ведет себя иначе, чем шаблон. Работник все еще проверяет новую страницу и координирует ее жизненный цикл с контроллером.
Автоматизация с учетом страниц. Арендуйте объекты страниц одной работы и подтверждайте точный открыватель или утвержденный пункт назначения.
Обзор оператора. Используйте задокументированную диагностику или Live View, если многостраничный поток требует инспекции под наблюдением.
Предсказуемая очистка. Закрывайте только страницы, созданные рабочим процессом, и проверяйте управляемое завершение через его отдельный жизненный цикл.
Что должен установить многостраничный регрессионный тест?
Многостраничный регрессионный тест должен установить, что ожидаемое действие пользователя создало именно целевую страницу и сохранило или изменило открыватель, как задумано. Запустите тест с другой страницей, сравните маркер приложения и вызовите контролируемый сбой, когда всплывающее окно не отображает ожидаемую ревизию. Запишите выбранный результат вместо общего количества вкладок.
Для рабочего процесса захвата добавьте проверенные удаленные скриншоты только после того, как сможете идентифицировать предполагаемую дочернюю страницу и ее стабильное содержимое.
Q: В чем разница между событиями всплывающего окна и страницы?
Событие всплывающего окна принадлежит известному открывателю. Событие страницы в контексте браузера может более широко наблюдать за новыми страницами, созданными в этом контексте.
Q: Нужен ли Playwright для визуального фокуса новой вкладки?
Действия Playwright нацелены на объект страницы, который вы используете. Убедитесь, что возвращаемый объект представляет собой целевую страницу.
Q: Можно ли считать, что context.pages().at(-1) — это новая страница?
Избегайте полагаться на порядок страниц для определения владения. Зафиксируйте соответствующее событие и проверьте метку цели или задачи.
Q: Что если ссылка остается в той же вкладке?
Дождитесь ожидаемого URL оригинальной страницы и проверьте полученное содержимое. Навигация в той же вкладке не вызывает событие всплывающего окна открывателя.
Q: Должно ли закрытие всплывающего окна закрывать управляемый браузер?
Закройте всплывающее окно, которое вы держите, не завершая не связанные процессы браузера. Завершите управляемую сессию через контроллер-владелец, когда его работа будет выполнена.
Marcus Chen
Nov. 20th 2026
Запускайте облачные браузеры по запросу
Работайте с отпечатками браузера и CAPTCHA
Автоматизируйте процессы и расширяйте возможности ИИ-агентов
От сбора веб-данных и тестирования до автоматизации с ИИ — запускайте всё в облаке.