Đăng ký sự kiện tải xuống của Playwright trước khi kích hoạt xuất.
Sử dụng download.saveAs() để lưu kết quả vào một vị trí do worker sở hữu trước khi dọn dẹp trình duyệt.
Xem tên tệp được đề xuất như một siêu dữ liệu. Chọn điểm đến của riêng bạn và kiểm tra số byte đã tải xuống.
Yêu cầu kiểm tra nội dung, lược đồ hoặc phiên bản trước khi đánh dấu một xuất được chấp nhận.
Sử dụng trạng thái xuất của ứng dụng để hòa giải một tệp bị thiếu hoặc bị gián đoạn.
Kiểm tra việc chuyển giao đối tượng với kết nối quản lý chính xác của bạn, sau đó đóng trang và xác nhận kết thúc phiên riêng biệt.
Điều gì xảy ra khi Playwright tải xuống một tệp từ trình duyệt từ xa?
Một tệp tải xuống bắt đầu trong trình duyệt sau một hành động trên trang. Playwright cung cấp một đối tượng tải xuống có thể báo cáo URL nguồn, tên đề xuất và kết quả chuyển giao. Worker của bạn có thể lưu một tệp tải xuống hỗ trợ vào một đường dẫn cụ thể, sau đó xác minh những gì thực sự đến. Nstdata cung cấp các phiên trình duyệt được quản lý cho các quy trình làm việc cần tương tác với các ứng dụng và lấy đầu ra.
Một ví dụ hữu ích là báo cáo tồn kho staging đã được ủy quyền. Nhóm mong đợi một tệp CSV chứa SKU và số lượng sản phẩm cố định đã biết. Một cú nhấp vào Xuất có thể thành công trong khi tệp được tạo chỉ chứa một tiêu đề, dữ liệu cũ hoặc một payload lỗi. Chấp nhận kết quả chỉ sau khi kiểm tra nội dung đã lưu. hướng dẫn kiểm tra trình duyệt end-to-end phân tách sự hoàn thành của một hành động ra khỏi một khẳng định kinh doanh, điều này cũng áp dụng cho các tệp.
Các trường tải xuống của Playwright nào bạn nên sử dụng?
Sử dụng sự kiện tải xuống để xác định đối tượng, failure() để kiểm tra kết quả chuyển giao, và saveAs() để xuất tệp vào một đường dẫn do worker sở hữu. Lấy danh tính đối tượng mong đợi từ công việc, thay vì chấp nhận bất kỳ tệp đính kèm nào đến trước. mô tả các phương pháp này và giới hạn kết nối từ xa của .
Theo dõi để xem tải xuống hoặc trạng thái ứng dụng mong đợi
Sự kiện tải xuống
Trình duyệt đã nhận một đính kèm
Liên hệ nó với trang, hành động và đối tượng mong đợi
Tên tệp đề xuất
Tên được trình duyệt đề xuất
Sử dụng một đường dẫn an toàn do worker sở hữu thay vì nối nó vào một vị trí trong hệ thống tệp
failure() trả về null
Trình duyệt báo cáo không có lỗi chuyển giao
Lưu đối tượng và xác minh nội dung của nó
Tệp đã được lưu
Worker đã nhận byte
Kiểm tra loại, lược đồ, phiên bản nguồn và các bản ghi yêu cầu
Một tải xuống của Playwright thuộc về ngữ cảnh trình duyệt đã tạo ra nó. hướng dẫn tải xuống Playwright lưu ý rằng dọn dẹp ngữ cảnh sẽ xóa các tải xuống tạm thời. Lưu bản sao của bạn trước khi đóng trang hoặc ngữ cảnh. Trong một môi trường chạy được quản lý, xác minh cách nhà cung cấp của bạn và khách hàng cung cấp đối tượng, đặc biệt khi trình duyệt và worker sử dụng các hệ thống tệp riêng biệt.
Làm thế nào để bạn lưu và xác minh một xuất tồn kho?
Sử dụng fixture bạn đồng hành để kích hoạt một xuất CSV. Gắn một trình duyệt, lưu vào một thư mục tạm thời được cô lập, và so sánh số byte với bản ghi mong đợi. Ví dụ chạy trên Node.js 22 với playwright-core@1.65.1. Cài đặt Chromium cục bộ với npx playwright-core install chromium và chạy node fixture.mjs để phục vụ ứng dụng loopback đã được phê duyệt.
Bước 1. Chỉ định quy tắc chấp nhận tệp
Bài kiểm tra mong đợi một tiêu đề và một hàng cho TEST-42. Trang xuất phát và lộ trình CSV được cố định bởi fixture. Đối với các quy trình làm việc thực tế, thêm ID báo cáo và phiên bản hoặc khoảng thời gian yêu cầu. Nếu ứng dụng tạo ra ID xuất, hãy sử dụng chúng để kết nối một tải xuống bị trì hoãn với hành động gốc của nó.
Bước 2. Mở fixture với trình duyệt đúng
Khởi động fixture cục bộ và lưu các mô-đun chia sẻ. Khách hàng cục bộ khởi động Chromium. Người xác minh cũng kiểm tra khách hàng qua CDP trên một môi trường chạy Chromium tạm thời. Một bài kiểm tra được quản lý yêu cầu một không gian làm việc Nstdata được ủy quyền và một phiên sẵn sàng. Cung cấp thông tin xác thực và biến phiên đã được tài liệu hóa, sau đó sử dụng một phiên bản staging đã được phê duyệt của fixture mà trình duyệt quản lý có thể truy cập. Xác minh đường dẫn nhà cung cấp trong không gian làm việc của bạn trước khi phụ thuộc vào nó. Tham khảo tự động hoá trình duyệt đám mây.
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();}}}
Bước 3. Chờ tải xuống trước khi lưu
Chạy node download.mjs với trang thử nghiệm đang hoạt động. Kịch bản tạo ra lời hứa sự kiện trước khi nhấp vào liên kết xuất. Nó xác nhận rằng sự kiện đến từ lộ trình xuất mong đợi của trang thử nghiệm, lưu tải xuống hoàn chỉnh dưới tên tệp đã kiểm soát, và so sánh các byte. Nó in ra một kiểm tra băm bằng API crypto của Node.js. Thư mục tạm thời sẽ bị xóa sau ví dụ. Một công nhân sản xuất nên sao chép một hiện vật được chấp nhận vào kho lưu trữ đã phê duyệt trước khi xóa tệp tạm dừng của nó.
Ghi lại ID của artifact, kết quả xác thực, checksum nếu quy trình làm việc của bạn sử dụng, và cách xử lý theo chính sách giữ dữ liệu của bạn. Ví dụ in ra một hàng được chấp nhận và một băm SHA-256. Nếu một phiên quản lý được sử dụng, hãy xác minh rằng bộ điều khiển dừng nó sau khi chuyển giao. Hướng dẫn chu kỳ phiên trình duyệt browser session lifecycle guide giải thích sự khác biệt giữa ngắt kết nối và dừng bên dịch vụ.
[Ảnh chụp màn hình: Hiển thị thiết bị kiểm kê đã được ủy quyền và kết quả đầu ra an toàn với số lượng hàng và checksum. Loại trừ thông tin tài khoản và địa chỉ đã ký.]
Tại sao một xuất khẩu lại thiếu sau khi bạn nhấp vào Tải xuống?
Một xuất khẩu thiếu có thể có nghĩa là ứng dụng vẫn đang tạo báo cáo, trang sai sở hữu việc tải xuống, chuyển giao trình duyệt bị thất bại, hoặc quy trình dọn dẹp đã diễn ra trước khi nhân viên lưu tệp. Chẩn đoán cột mốc thiếu sớm nhất.
Triệu chứng
Chứng cứ cần thu thập
Hành động khắc phục
Không có sự kiện tải xuống
Chỉ số công việc xuất khẩu và trang khởi tạo
Theo dõi trạng thái ứng dụng đã được tài liệu hóa và lắng nghe trang nhận tệp đính kèm
Sự kiện xuất hiện nhưng tệp không có
Thất bại trong việc chuyển giao và địa điểm lưu
Lưu trước khi đóng ngữ cảnh và xác nhận đường dẫn lưu trữ của nhân viên
Tệp trống hoặc không hợp lệ
Lược đồ, phiên bản dự kiến và phản hồi lỗi
Từ chối nó và đối chiếu với xuất khẩu ứng dụng gốc
Báo cáo xuất hiện hai lần
Lịch sử công việc và định danh xuất khẩu
Tái sử dụng kết quả đã được chấp nhận hoặc điều chỉnh trước khi bắt đầu xuất khẩu mới
Kết quả hợp lệ mà không có dọn dẹp
Trạng thái phiên quản lý và chủ sở hữu dừng
Giữ theo dõi dọn dẹp cho đến khi phiên ở trạng thái cuối
Một số ứng dụng hiển thị PDF trong dòng hoặc mở một trang mới thay vì gửi một tệp đính kèm. Khớp quy trình làm việc với những gì ứng dụng đó thực sự làm. Khi một tệp đính kèm chứa dữ liệu bạn được ủy quyền xử lý, hãy xác thực nội dung mà không in tệp hoặc URL đã ký vào nhật ký chung. Hướng dẫn gỡ lỗi trình duyệt browser debugging walkthrough giúp phân lập sự khác biệt giữa sự kiện trình duyệt bị trì hoãn và yêu cầu máy chủ thất bại.
Làm thế nào bạn có thể phát hiện một CSV cũ hoặc một phần?
Phát hiện các xuất khẩu cũ hoặc một phần bằng cách kiểm tra danh tính báo cáo của lần chạy, các cột dự kiến và các bản ghi yêu cầu sau khi chuyển giao kết thúc. Trong một CSV nhiều hàng, xác thực lược đồ và số lượng hoặc phiên bản do máy chủ xác định khi có sẵn. Tên tệp và thời gian sửa đổi có thể được sử dụng lại trong khi nội dung thay đổi. Một thiết bị nghiêm ngặt có thể so sánh các byte chính xác, trong khi một báo cáo sản xuất đang thay đổi thường cần các kiểm tra dựa trên nhiệm vụ đã được phân tích.
Một tab trình duyệt có thể tải xuống một tệp hợp lệ cho bộ lọc sai. Sử dụng phạm vi hoặc phiên bản dự kiến của nhiệm vụ đầu vào để xác thực đầu ra và giữ đủ thông tin để tái tạo phán quyết. Nếu một ID xuất khẩu tồn tại, hãy so sánh nó với công việc được tạo ra bởi hành động và coi các sự không khớp là chưa được giải quyết. Đánh dấu một artifact hợp lệ được chấp nhận trước khi chuyển nó đến một địa điểm được bảo vệ.
Nstdata Cloud Browser phù hợp với quy trình xuất khẩu được kiểm soát như thế nào?
Nstdata Cloud Browser cung cấp một môi trường trình duyệt được quản lý cho các quy trình làm việc cần tương tác trước khi một artifact trở nên có sẵn. Sử dụng kết nối CDP được hỗ trợ để kết nối với ứng dụng và chu kỳ tải xuống của khách hàng để quan sát quá trình hoàn tất. Ứng dụng của bạn vẫn chọn nơi lưu trữ các tệp được ủy quyền, kiểm tra chất lượng dữ liệu và lập lịch dọn dẹp. Một kết nối được quản lý có thể có hành vi chuyển giao artifact cụ thể cho môi trường, vì vậy hãy làm cho một thiết bị tùy chỉnh là một phần của bài kiểm tra tích hợp trước khi mở rộng một công việc.
Xuất khẩu tương tác. Sử dụng một phiên đã sở hữu để điều hành ứng dụng đã được phê duyệt và xác nhận artifact mà nó tạo ra.
Chẩn đoán thất bại. Kiểm tra các quan sát trên trình duyệt đã được tài liệu hóa khi có sẵn. Liên kết chúng với trạng thái xuất khẩu thay vì giả định rằng nhấp chuột UI đã hoàn tất công việc.
Dọn dẹp thời gian chạy riêng. Giải phóng trình duyệt khi artifact đã được chấp nhận được bảo vệ và trạng thái cuối cùng được nhìn thấy.
Một bài kiểm tra tải xuống có thể tái sử dụng nên chứng minh điều gì?
Một bài kiểm tra tải xuống có thể tái sử dụng nên chứng minh rằng một hành động đã được phê duyệt tạo ra một tệp được mong đợi, nhân viên đã xác thực nội dung của nó, và cả artifact và trình duyệt đều được xử lý theo các quy tắc dọn dẹp đã biết. Kiểm tra một CSV thành công, một thất bại rõ ràng, và một báo cáo hoàn thành sau một thời gian chờ có thể nhìn thấy. Giữ dữ liệu mong đợi độc lập với kịch bản ghi hình để một trang bị hỏng không thể định nghĩa lại sự thành công.
Khi xác nhận bằng hình ảnh hữu ích hơn so với việc chuyển file, hãy sử dụng kiểm tra ảnh chụp màn hình trình duyệt từ xa cho một artefact trình duyệt riêng biệt và xác minh những gì mỗi đầu ra thực sự chứng minh.
Q: Bạn có thể gọi download.path() khi kết nối từ xa không?
Playwright tài liệu một hạn chế kết nối từ xa cho download.path(). Kiểm tra download.saveAs() với nhà cung cấp thực tế và client đã cấu hình của bạn.
Q: Khi nào bạn nên tạo promise sự kiện tải xuống?
Tạo nó trước hành động kích hoạt file. Thứ tự này cho phép client quan sát một lần tải xuống bắt đầu ngay lập tức.
Q: Tên file gợi ý có đáng tin cậy như một đường dẫn lưu trữ không?
Xem nó như là metadata hiển thị cho người dùng. Chọn một đường dẫn worker có kiểm soát và giữ lại việc xác thực tên file hoặc loại riêng biệt.
Q: Khi nào bạn nên dừng một trình duyệt được quản lý sau khi xuất?
Lưu và xác thực file trước, bảo tồn artefact đã chấp nhận theo quy tắc lưu trữ của bạn, và sau đó dừng phiên quản lý.
Q: Một checksum có chứng minh tính đúng đắn của xuất không?
Một checksum xác định các byte chính xác. So sánh nội dung mong đợi hoặc báo cáo danh tính để xác định xem những byte đó có đại diện cho kết quả mong muốn hay không.
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.