Cách tải lên tệp trong trình duyệt từ xa với Playwright
TL;DR
Sử dụng locator.setInputFiles() cho một đầu vào tệp thực tế trong một ứng dụng được ủy quyền.
Chờ sự kiện filechooser trước khi nhấp vào một điều khiển tùy chỉnh mở trình chọn tệp.
Sử dụng một Buffer được đặt tên nhỏ cho một bài kiểm tra tổng hợp, với một tên tệp và loại MIME mà biểu mẫu mong đợi.
Xác minh việc chọn tệp, kết quả gửi, và biên lai phía máy chủ như những cột mốc riêng biệt.
Giữ các tệp kiểm tra không chứa bí mật và dữ liệu cá nhân. Kiểm tra tệp hiện tại, đường dẫn, và giới hạn trình duyệt với môi trường dự kiến.
Đóng trang bạn đã tạo và xác minh kết thúc của trình duyệt được quản lý khi công việc của nó hoàn tất.
Playwright tải lên một tệp vào trình duyệt từ xa như thế nào?
Playwright tải lên một tệp bằng cách thiết lập đầu vào tệp của trình duyệt hoặc bằng cách cung cấp các tệp cho một trình chọn đã được ghi lại. Worker bắt đầu với các byte của fixture và trang khởi động hành động ứng dụng. Bạn vẫn cần xác thực những gì ứng dụng nhận được và liệu giao dịch mục tiêu đã được cam kết. Nstdata cung cấp các phiên Chromium được quản lý có thể được điều khiển thông qua một khách hàng Playwright đính kèm.
Một bài kiểm tra đơn giản có thể cho thấy một tên tệp đã chọn và vẫn thất bại trong việc truyền tải tệp. Ví dụ, phần giao diện phía trước hiển thị một lựa chọn hợp lệ trong khi một tải lên nền nhận được sự từ chối từ máy chủ. Bắt đầu với một biểu mẫu được ủy quyền, một tệp tổng hợp nhỏ, và một biên lai máy chủ đã biết. Hướng dẫn tự động hóa biểu mẫu Playwright đề cập đến sự phân chia tương tự giữa việc nhấp gửi và chứng minh một kết quả đã cam kết.
Khi nào bạn nên sử dụng đầu vào tệp hoặc trình chọn?
Sử dụng đầu vào tệp khi trang hiển thị input[type="file"] với một nhãn có thể truy cập được hoặc định vị ổn định. Sử dụng sự kiện trình chọn tệp khi ứng dụng mở trình chọn qua một nút và đầu vào là tạm thời. Phương pháp phù hợp phụ thuộc vào cách mà trang được ủy quyền cung cấp việc chọn tệp.
Nstdata Cloud Browser Trình duyệt của bạn trên đám mây
Bề mặt ứng dụng
Phương pháp Playwright
Kiểm tra chấp nhận
Đầu vào tệp được gán nhãn
locator.setInputFiles()
Tệp tổng hợp đúng được chọn và biên lai mong đợi sau khi gửi
Trình chọn được kích hoạt bởi một nút
page.waitForEvent('filechooser') và chooser.setFiles()
Nhấp mở trình chọn dự kiến và ứng dụng chấp nhận tệp
Tải lên ngay lập tức sau khi lựa chọn
Đầu vào tệp hoặc trình chọn tùy thuộc vào UI
Chờ dấu hiệu hoàn tất bền vững của ứng dụng
Quy trình nhiều tệp
Cung cấp các tệp mong đợi chỉ khi đầu vào hỗ trợ chúng
Xác nhận tập hợp được chấp nhận hoàn chỉnh và xử lý sự từ chối một phần
Tài liệu Playwright input documentation mô tả các đường dẫn và dữ liệu tệp trong bộ nhớ. Tài liệu FileChooser API reference ghi lại việc cung cấp tệp sau sự kiện trình chọn. Một Buffer được đặt tên làm cho các byte của fixture trở nên tự chứa và tránh phụ thuộc vào một tệp được sao chép vào hệ thống tệp của runtime. Xác minh đường dẫn chuyển nhượng và bất kỳ giới hạn nào áp dụng trước khi sử dụng tài sản thực.
Bạn nên chuẩn bị gì cho một bài kiểm tra tải lên?
Chuẩn bị một nguồn gốc kiểm tra đã được chấp nhận, nội dung tệp tổng hợp, và một quy tắc chấp nhận có thể kiểm tra độc lập. Ghi lại nhãn trường, loại tệp, kích thước được phép, và tên tệp hoặc định dạng biên lai mong đợi. Đối chiếu những chi tiết này với ứng dụng mà bạn có quyền kiểm tra. Một bản xem trước hiển thị là hữu ích như một tín hiệu tạm thời. Một biên lai hoặc hồ sơ ứng dụng chứng minh liệu máy chủ đã chấp nhận tệp hay chưa.
Chọn một trường hợp từ chối mong đợi như một tên tệp hợp lệ nhưng không chấp nhận được. Sử dụng chính sách kiểm tra hiện có của ứng dụng của bạn và một tải lên nhỏ hạn chế, đặc biệt nếu hành động ghi dữ liệu. Đặt một chủ sở hữu dọn dẹp cho các artefact kiểm tra bên ngoài trình duyệt, vì việc đóng một trình duyệt có thể để lại các bản ghi được lưu trong ứng dụng.
Bạn gắn và gửi một tệp tổng hợp như thế nào?
Bắt đầu fixture đi kèm, kết nối một trình duyệt, và gửi nội dung tải lên kiểm tra nhỏ đến trang xem xét cố định. Ví dụ này sử dụng Node.js 22 và playwright-core@1.65.1. Sử dụng npx playwright-core install chromium và node fixture.mjs cho một lần chạy cục bộ. Fixture liên kết với 127.0.0.1 và phục vụ /upload tại cổng 4173 theo mặc định.
Bước 1. Xác nhận định dạng mục tiêu và biên lai
Ứng dụng cục bộ chấp nhận một tệp có tên fixture.txt chứa 15 byte. Nó viết một biên lai sau khi API đọc tệp, vì vậy bài kiểm tra có thể phân biệt sự xác nhận đúng đắn từ một điều khiển trống. Xác nhận mục tiêu sử dụng nguồn gốc và tài khoản sandbox dự kiến trước khi chọn một tệp. Cài đặt tự động hóa trình duyệt.
Bước 2. Chuẩn bị khách hàng trình duyệt
Lưu các mô-đun đi kèm. Một lần chạy cục bộ khởi động Chromium trực tiếp. Một bài kiểm tra khách hàng từ xa cách ly có thể sử dụng địa chỉ CDP vòng lặp của trình xác minh. Đối với một lần chạy được quản lý, hãy sử dụng một phiên đã sẵn sàng, được ủy quyền, một ứng dụng kiểm tra đã được phê duyệt có thể truy cập bởi trình duyệt đám mây, và các cấu hình NSTDATA_API_KEY, NSTDATA_SESSION_ID, và tùy chọn NSTDATA_TEAM_ID đã được tài liệu hóa. Giữ khóa tách biệt với thông tin xác thực CDP được phát hành. Trình duyệt cục bộ và các nhánh CDP cục bộ thực hiện thao tác của khách hàng. Nhánh được quản lý yêu cầu ủy quyền không gian làm việc của riêng bạn và thiết bị tương đương.
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. Đính kèm payload thử nghiệm
Lưu ví dụ dưới dạng upload.mjs. Khởi động máy chủ thử nghiệm, sau đó chạy node upload.mjs. Kịch bản gửi một tên, loại MIME và Buffer đến đầu vào được gán nhãn. Nó sử dụng một nhãn điều khiển chính xác và gửi một lần. Nếu trang được ủy quyền thực tế của bạn chỉ hiển thị một trình chọn, hãy đăng ký lời hứa sự kiện trước khi nhấp vào nút của nó, sau đó gọi setFiles() với payload đã được xác minh.
Sử dụng kết quả liên quan đến tệp thử nghiệm đã gửi và xác minh những gì đã được chấp nhận. Tại đây, máy chủ báo cáo tên tệp và số byte và kịch bản phát ra một bản ghi chấp nhận gọn gàng. Một ứng dụng sản xuất có thể sử dụng ID tải lên, trạng thái quét đang chờ, hoặc một artefact đã được lưu. Chờ đợi cho bất kỳ tín hiệu nào xác định sự chấp nhận trong ứng dụng đó. Tài liệu tính khả thi của Playwright mô tả điều gì mà một hành động thành công đang chờ, điều này khác với những gì ứng dụng thực hiện sau đó.
![Ảnh chụp màn hình: Hiện biểu mẫu thử nghiệm với tệp tổng hợp được chọn và biên nhận xác nhận số byte của nó.]
Tại sao tệp có thể được chọn trong khi tải lên vẫn thất bại?
Một tệp có thể xuất hiện trong đầu vào ngay cả khi ứng dụng từ chối nó hoặc chưa hoàn tất quá trình xử lý. Kiểm tra giai đoạn đã tạo ra tín hiệu đáng tin cậy cuối cùng. Thời gian chờ tìm kiếm chỉ vào trang hoặc điều khiển. Lỗi máy chủ sau khi tệp được chọn chỉ ra xác thực biểu mẫu, yêu cầu, hoặc quy trình xử lý backend. Ghi nhật ký nội dung tệp thô không thêm giá trị chẩn đoán nhiều.
Triệu chứng
Cần kiểm tra điều gì
Phản ứng an toàn
Đầu vào hết thời gian
Nhãn, trang chính xác, ranh giới iframe
Định vị đầu vào mong muốn trong trang được chấp thuận
Sự kiện chọn không bao giờ xuất hiện
Hành vi điều khiển và thứ tự đăng ký sự kiện
Đăng ký sự kiện đúng trước hành động
Kích thước tệp sai
Dữ liệu thử nghiệm và mã hóa
So sánh số byte mong đợi với biên nhận của máy chủ
Biên nhận không có sau khi gửi
Kết quả yêu cầu và bản ghi của ứng dụng
Đối chiếu trước khi gửi lại
Hướng dẫn gỡ lỗi mạng và console trình duyệt giúp phân biệt kết quả UI hiển thị từ một phản hồi hoặc lỗi truyền tải. Khi mục tiêu của bạn sử dụng quét nền, giữ lại ID tải lên và kiểm tra trạng thái an toàn đã được tài liệu của nó thay vì gửi tệp lại.
Công việc tải lên nên xử lý lỗi xác thực như thế nào?
Một công việc tải lên nên giữ lại nỗ lực ban đầu và phân loại phản hồi trước khi gửi thêm byte. Khi bị từ chối thử nghiệm, giữ lại tên tệp an toàn, kích thước mong đợi, thể loại phản hồi và trạng thái biên nhận của ứng dụng. Chạy một tải trọng tổng hợp cố tình bị từ chối với một trường bị thay đổi, và xác minh rằng UI báo cáo bị từ chối mà không tạo ra bản ghi được chấp nhận. Nếu yêu cầu đầu tiên có thể đã thành công và biên nhận không có, hãy tham khảo ứng dụng sử dụng định danh tải lên của nó hoặc một chế độ xem trạng thái chỉ đọc khác.
Ràng buộc từng thử nghiệm tiêu cực với một tệp nhỏ trong một môi trường được phê duyệt rõ ràng cho việc từ chối thử nghiệm. Lưu một bản ghi chẩn đoán ngắn và xóa bất kỳ dữ liệu thử nghiệm nào đã được lưu bằng quy trình dọn dẹp mà mục tiêu đã chỉ định.
Làm thế nào Nstdata Cloud Browser phù hợp với QA tải lên?
Nstdata Cloud Browser cung cấp runtime Chromium được quản lý cho quy trình làm việc tệp được ủy quyền. Một kịch bản Playwright vẫn xây dựng đầu vào tệp, thực hiện hành động biểu mẫu theo kế hoạch, và xác minh những gì ứng dụng ghi lại. Live View hoặc chẩn đoán trình duyệt được phép có thể giúp một điều hành viên điều tra một tải lên đi qua nhiều giai đoạn UI. Quyền truy cập vào ứng dụng mục tiêu, ràng buộc tệp, và xóa dữ liệu thử nghiệm đã lưu vẫn là một phần của thiết kế ứng dụng của bạn.
Gắn kết từ xa. Sử dụng quy trình CDP được hỗ trợ với một phiên sở hữu và trang mục tiêu đã được xác minh.
Fixture có thể tái sử dụng. Giữ một tải trọng byte nhỏ đã được phê duyệt trong công nhân và xác nhận biên nhận máy chủ mong đợi.
Dọn dẹp có chủ ý. Đóng trang bạn sở hữu và dừng trình duyệt được quản lý riêng biệt; xóa các bản ghi thử nghiệm qua con đường được phê duyệt của ứng dụng.
Một bài kiểm tra khói tải lên có thể lặp lại nên chứng minh điều gì?
Một bài kiểm tra khói tải lên có thể lặp lại nên chứng minh rằng tệp dự kiến đã được chọn, máy chủ đã chấp nhận nó một lần, và trình duyệt cũng như các tệp cố định đã lưu có các chủ sở hữu dọn dẹp đã được xác định. Bắt đầu với mẫu nhỏ nhất được phép và xác minh cả việc nhận thành công và một sự cố xác thực. Khi một kết quả ngẫu nhiên cần xem xét, hãy sử dụng quy trình phát lại phiên Cloud Browser với dữ liệu tổng hợp và thời gian lưu trữ đã được phê duyệt.
Q: Playwright có thể gán một Buffer cho đầu vào tệp không?
Có. Sử dụng một đối tượng với name, mimeType, và buffer cho API đầu vào tệp đã được tài liệu hóa.
Q: Thì sao nếu nút tải lên mở một trình chọn tệp native?
Chờ sự kiện filechooser của trang trước khi nhấp, sau đó cung cấp tải trọng tệp thông qua trình chọn đã trả về.
Q: Một bản xem trước tệp có chứng minh rằng máy chủ đã chấp nhận nó không?
Kiểm tra biên nhận hoặc trạng thái ứng dụng bền bỉ. Một bản xem trước chủ yếu chứng minh rằng khách hàng biết tệp nào đã được chọn.
Q: Bạn có nên thử gửi lại nếu phản hồi bị mất không?
Kiểm tra biên nhận tải lên gốc trước. Lặp lại việc gửi chỉ khi bạn có thể xác lập kết quả an toàn theo các quy tắc của ứng dụng.
Q: Một phiên đám mây có thể mở URL tệp cố định địa phương không?
Một trình duyệt đám mây có môi trường mạng riêng. Sử dụng một tệp cố định staging đã được phê duyệt tương đương mà trình duyệt đám mây có thể truy cập, hoặc chạy thử nghiệm trên đường dẫn trình duyệt địa phươ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.