Cách xử lý cửa sổ bật lên và tab mới trong Playwright
TL;DR
Sử dụng sự kiện popup của trang mở ra khi một hành động đã biết tạo ra một tab hoặc cửa sổ con.
Sử dụng sự kiện page của ngữ cảnh trình duyệt khi người tạo không rõ ràng hoặc bạn cố ý giám sát tất cả các trang mới trong ngữ cảnh đó.
Đăng ký lời hứa sự kiện trước khi nhấp chuột và ràng buộc thời gian mà khách hàng sẽ chờ đợi.
Xác minh đích đến và một dấu hiệu cụ thể của nhiệm vụ trước khi tương tác với trang mới.
Sử dụng chờ điều hướng cho đường đi trong cùng một tab và một trình xử lý hộp thoại cho các hộp thoại JavaScript.
Chỉ đóng các trang thuộc về nhiệm vụ, sau đó xác minh việc dọn dẹp phiên đã quản lý qua bộ điều khiển.
Làm thế nào để bạn xử lý một popup hoặc tab mới trong Playwright?
Xử lý một popup bằng cách chờ sự kiện từ trang sẽ mở nó, sau đó coi trang trả về như một mục tiêu tự động hóa riêng biệt. Kiểm tra đích đến thực tế và trạng thái ứng dụng mong đợi trước khi phát hành một hành động khác. Nstdata cung cấp các trình duyệt được quản lý mà khách hàng Playwright được hỗ trợ có thể kết nối và quản lý hơn một trang.
Xem xét một hàng đợi xem xét staging với một liên kết mở một bản xem trước phiên bản. Một tab trạng thái không liên quan cũng đang mở. Chọn phần tử gần đây nhất trong context.pages() giả định rằng không có công nhân hoặc trang khác tạo ra một tab. Thiết kế an toàn hơn chờ sự kiện từ người mở được biết và xác minh rằng trang trả về hiển thị đúng phiên bản. Đối với các trường hợp mà ai đó mở một trang một cách thủ công trước, xem quy trình bàn giao người điều hành.
Sự kiện nào phù hợp với hành vi của ứng dụng của bạn?
Chọn sự kiện tương ứng với những gì trang thực sự tạo ra. Một modal DOM mới giữ cùng một trang Playwright và cần các bộ định vị thông thường. Một hộp thoại được tạo bởi JavaScript là một sự kiện riêng biệt. Một tab mới được đại diện bởi một trang khác, và một điều hướng cùng tab thay đổi URL của trang gốc.
Làm thế nào để bạn bắt giữ bản xem trước phiên bản mà bạn mong đợi?
Bắt giữ popup từ trang xem xét đã biết và yêu cầu một URL fixture chính xác và mã định danh phiên bản. Ví dụ sử dụng một fixture staging cục bộ và một tab bổ sung để bắt giữ một lỗi phổ biến. Nó chạy trên Node.js 22 và playwright-core@1.65.1. Sử dụng tệp đi kèm fixture.mjs và cài đặt Chromium cục bộ với npx playwright-core install chromium cho đường đi độc lập.
Bước 1. Chuẩn bị người mở và trang con mong đợi
Bắt đầu node fixture.mjs. Người mở được phê duyệt là /opener và trang con mong đợi là /child. Trang con hiển thị tiêu đề Bản xem trước phiên bản và một dấu hiệu cho fixture-42. Kịch bản cũng tạo ra một tab giả mạo cho /status. Trong một ứng dụng thực tế, lấy đích đến được phê duyệt và dấu hiệu từ mục công việc được ủy quyền trước khi bắt đầu nhấp chuột.
Bước 2. Kết nối một công nhân đến trình duyệt đúng
Lưu trữ các mô-đun chia sẻ và chọn một đường dẫn chạy cục bộ hoặc xác minh CDP vòng lặp. Nếu bạn đang sử dụng một trình duyệt được quản lý, hãy sử dụng một phiên đã sẵn sàng được sở hữu và một mục tiêu được phê duyệt tương ứng có thể tiếp cận từ môi trường đó. Cấu hình NSTDATA_API_KEY, NSTDATA_SESSION_ID, và lựa chọn không bắt buộc cho không gian làm việc. Quy trình làm việc đã được thực hiện trên Chromium cục bộ và CDP vòng lặp. Nó cần một không gian làm việc được ủy quyền để kiểm tra nhánh đã quản lý. Hướng dẫn tự động hóa trình duyệt 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();}}}
Step 3. Đăng ký sự kiện và nhấp chuột
Lưu ví dụ này dưới dạng popup.mjs, sau đó chạy node popup.mjs. Lời hứa sự kiện được đăng ký trước khi nhấp vào liên kết. Popup trả về được giữ trong một biến riêng. Kịch bản xác minh tuyến đường của nó và rằng nội dung của nó tham chiếu đến sự sửa đổi thử nghiệm mong đợi. Nó cũng chứng minh rằng opener không điều hướng ra ngoài và rằng popup thuộc về trang đó. Tài liệu Tài liệu tham khảo API Trang Playwright ghi lại các ngữ nghĩa popup và opener.
Step 4. Kết thúc quy trình làm việc con dưới quyền sở hữu đã biết
Đóng trẻ em và mồi được tạo bởi ví dụ. Nếu một công việc khác sở hữu các tab trong thời gian chạy đó, hãy để các tab đó được yên. Ghi lại trang nào mà kết quả đến từ đó. Dừng phiên quản lý chỉ khi bộ điều khiển xác minh rằng tất cả công việc được ủy quyền trên đó đã hoàn thành. Hướng dẫn quản lý phiên trình duyệt chỉ ra nơi mà việc tắt nên thuộc về.
![Ảnh chụp màn hình: Hiển thị trang đánh giá staging và bản xem trước trẻ em đã được xác minh với ID phát hành tổng hợp. Giữ các tab và địa chỉ đã ký khác bên ngoài ảnh chụp màn hình.]
Tại sao thời gian chờ popup lại hết hoặc nhắm mục tiêu sai tab?
Một thời gian chờ popup thường thất bại vì trình lắng nghe đến muộn, người mở không đúng, ứng dụng điều hướng trong cùng một tab, hoặc nội dung mong đợi không bao giờ đến. Tìm ra cột mốc nào đã xảy ra. Kiểm tra hành vi đã được tài liệu của nút và theo dõi trên trang thích hợp. Một tab có thể xuất hiện trước khi URL hoặc nội dung cuối cùng của nó sẵn sàng, vì vậy hãy xác minh cả hai một cách độc lập.
Triệu chứng
Giải thích có thể
Cách phục hồi
Sự kiện hết thời gian nhưng URL đã thay đổi
Trang gốc đã điều hướng
Chờ đợi đến đích cùng tab đã biết, sau đó xác minh nội dung
Sự kiện ngữ cảnh chọn một tab không liên quan
Trang khác đã tạo nó
Thu hẹp thời gian chờ dành cho người mở hoặc liên hệ trang đã trả về trước khi hành động
Tab mới mở với một trang trống
Điều hướng mục tiêu đang chờ hoặc thất bại
Chờ đợi lộ trình đã được phê duyệt và kết quả với một thời gian giới hạn
Popup đóng trước bước tiếp theo
Ứng dụng đã hoàn thành hoặc từ chối quy trình làm việc
Đọc biên nhận của cha mẹ hoặc máy chủ trước khi thử lại
Đích bất ngờ hoặc tab bổ sung
Quy trình làm việc khác với thiết bị đã được phê duyệt
Dừng hành động đó và điều tra với một định danh trang an toàn
Nếu trang mới là một phần của quy trình làm việc nhạy cảm, hãy giữ URL đầy đủ của nó ra khỏi nhật ký và tránh ghi lại các tab riêng tư theo mặc định. Hướng dẫn gỡ lỗi console và mạng giúp xác định trang nào và lộ trình nào thực sự gây ra thất bại.
Bạn xử lý thế nào với một quy trình làm việc đôi khi ở lại trong cùng một tab?
Xử lý điều hướng tùy chọn bằng cách xác định hai kết quả mong đợi và thêm một quan sát giới hạn cho mỗi kết quả. Một ứng dụng có thể mở một bản xem trước trong một tab mới chỉ cho một số vai trò tài khoản nhất định. Đo lường hành vi thực tế trong môi trường thử nghiệm đã được phê duyệt và giữ hợp đồng rõ ràng trong các trường hợp của bạn. Một cấu hình mà luôn sử dụng popup vẫn nên thất bại nếu nó lặng lẽ quay trở lại cha mẹ thay vào đó.
Đối với những lựa chọn thực sự, bắt đầu thời gian chờ thích hợp trước khi nhấp và giữ bất kỳ trình lắng nghe nào được thu hẹp cho hành động đó. Khi một kết quả được thiết lập, hủy bỏ hoặc loại bỏ quan sát không sử dụng một cách sạch sẽ để nó không ảnh hưởng đến bước tiếp theo. Xác minh mục tiêu tách biệt với loại chuyển tiếp. Ghép nối nguồn gốc mong đợi và phiên bản dự định trên cả hai lộ trình và giữ bằng chứng cho thấy lộ trình nào đã qua.
Nstdata Cloud Browser hỗ trợ quy trình làm việc nhiều trang như thế nào?
Nstdata Cloud Browser cung cấp các trình duyệt đám mây được quản lý cho tự động hóa trình duyệt và các tác nhân AI. Sử dụng CDP để gắn vào phiên đã chọn và suy ra quyền sở hữu trang từ ứng dụng và khách hàng. Live View cung cấp cho một nhà điều hành được ủy quyền một cách để xem xét trang đang hoạt động khi một luồng hành xử khác với thiết bị. Người làm việc vẫn xác minh trang mới và phối hợp thời gian tồn tại của nó với bộ điều khiển.
Tự động hóa nhận thức trang. Thuê đối tượng trang của một công việc và xác thực người mở chính xác hoặc đích đã được phê duyệt.
Xem xét của nhà điều hành. Sử dụng chẩn đoán đã được tài liệu hoặc Live View nếu một luồng nhiều trang cần điều tra có giám sát.
Dọn dẹp có thể dự đoán. Đóng chỉ các trang được tạo bởi quy trình làm việc và xác minh việc tắt được quản lý thông qua chu kỳ sống riêng của nó.
Một bài kiểm tra hồi quy đa tab nên xác lập điều gì?
Một bài kiểm tra hồi quy đa tab nên xác lập rằng hành động người dùng mong đợi đã tạo ra chính xác trang đích dự định và bảo tồn hoặc thay đổi người mở như đã thiết kế. Thực hiện một bài kiểm tra với một trang khác có mặt, so sánh dấu hiệu ứng dụng, và kích hoạt một thất bại có kiểm soát nơi popup không hiển thị phiên bản mong đợi. Ghi lại kết quả đã chọn thay vì một số lượng chung của các tab.
Đối với một quy trình làm việc ghi lại, thêm ảnh chụp màn hình từ xa đã được xác minh chỉ sau khi bạn có thể xác định trang con dự định và nội dung ổn định của nó.
Q: Sự khác biệt giữa sự kiện popup và trang là gì?
Sự kiện popup thuộc về một opener đã biết. Sự kiện trang trong một ngữ cảnh trình duyệt có thể quan sát các trang mới được tạo ra trong ngữ cảnh đó một cách rộng rãi hơn.
Q: Playwright có cần tab mới được tập trung thị giác không?
Các hành động của Playwright nhắm đến đối tượng trang mà bạn sử dụng. Xác minh rằng đối tượng được trả về đại diện cho trang dự định.
Q: Bạn có thể giả định context.pages().at(-1) là trang mới không?
Tránh dựa vào thứ tự trang để sở hữu. Ghi lại sự kiện tương ứng và kiểm tra mục tiêu hoặc đánh dấu công việc.
Q: Thì thế nào nếu liên kết ở lại trong cùng một tab?
Chờ đợi URL dự kiến của trang gốc và xác minh nội dung kết quả. Một điều hướng trong cùng một tab không phát ra sự kiện popup opener.
Q: Việc đóng một popup có nên đóng luôn trình duyệt đang quản lý không?
Đóng popup bạn sở hữu mà không kết thúc công việc trình duyệt không liên quan. Dừng phiên làm việc đang quản lý thông qua bộ điều khiển sở hữu khi nhiệm vụ của nó hoàn tất.
Marcus Chen
Nov. 20th 2026
Khởi chạy trình duyệt đám mây theo nhu cầu
Xử lý dấu vân tay trình duyệt và CAPTCHA
Tự động hóa quy trình và hỗ trợ tác nhân AI
Từ thu thập dữ liệu web và kiểm thử đến tự động hóa bằng AI, vận hành tất cả trên đám mây.