Cách Chụp Ảnh Màn Hình Tin Cậy Trong Trình Duyệt Từ Xa
TL;DR
Chụp ảnh màn hình trình duyệt từ xa chỉ sau khi trang mục tiêu và dữ liệu của nó đã sẵn sàng.
Sử dụng ảnh chụp viewport cho một viewport trình duyệt cố định, ảnh chụp toàn trang cho tài liệu hoàn chỉnh, hoặc ảnh chụp định vị cho một phần tử.
Ghi lại kích thước viewport, chiều cao cuộn trang, tỉ lệ pixel thiết bị và cấu hình trình duyệt bên cạnh hình ảnh.
Màn hình từ xa, viewport trang, pixel chụp màn hình và zoom Live View mô tả các phép đo khác nhau.
Sử dụng scale: 'css' khi bạn muốn kích thước dựa trên pixel CSS và xây dựng một bài kiểm tra riêng cho các kiểm tra hình ảnh có DPR cao.
Giữ thông tin đăng nhập và nội dung trang riêng tư ra khỏi tài liệu chia sẻ. Đóng trang chụp của bạn và kết thúc phiên quản lý.
Điều gì làm cho một ảnh chụp màn hình trình duyệt từ xa đáng tin cậy?
Một ảnh chụp màn hình trình duyệt từ xa đáng tin cậy cho thấy nội dung mong đợi từ trang mục tiêu trong một bố cục đã biết, với đủ siêu dữ liệu để lặp lại việc chụp. Một widget trống trong một PNG hợp lệ có thể có nghĩa là việc chụp quá sớm, ứng dụng đã trả về phản hồi sai, hoặc một lớp phủ đã chặn việc kết xuất. Sự tồn tại của tệp chứng minh rằng một lần chụp đã xảy ra. Một khẳng định trước khi chụp xác lập nội dung hình ảnh dự kiến sẽ hiển thị. Nstdata Cloud Browser.
Sử dụng một ví dụ kiểm soát như một báo cáo phát hành với tiêu đề và một dấu hiệu sẵn sàng bị trì hoãn. Trong mã dưới đây, ảnh chụp màn hình chờ Xây dựng 42 sẵn sàng và sự sẵn sàng của phông chữ tài liệu. Trong một công việc phát hành thực tế, cũng hãy chờ đợi khẳng định dữ liệu quan trọng. Hướng dẫn khắc phục sự cố tự động hóa trình duyệt giải thích cách chẩn đoán một dấu hiệu bị thiếu trước khi một tài liệu đến giai đoạn so sánh.
Bạn nên sử dụng phạm vi ảnh chụp nào?
Chọn phạm vi nhỏ nhất mà trả lời câu hỏi của bạn. Một hình ảnh cấp viewport có thể hiển thị cái nhìn đầu tiên của người dùng và xác nhận một tiêu đề cố định. Hình ảnh toàn trang hiển thị kích thước tài liệu và làm cho bằng chứng phía dưới có thể nhìn thấy khi nó thực sự đã được tải. Hình ảnh định vị cách ly một thành phần và tránh thay đổi bố cục không liên quan ở những nơi khác.
Nstdata Cloud Browser Trình duyệt của bạn trên đám mây
Chụp
Lệnh Playwright
Bằng chứng tốt
Biến chính
Viewport
page.screenshot()
Cái nhìn đầu tiên, hộp thoại hoặc điều hướng cố định
Chiều rộng, chiều cao, DPR và vị trí cuộn
Toàn trang
page.screenshot({ fullPage: true })
Bố cục tài liệu và nội dung có sẵn phía dưới
Chiều cao tài liệu và tải lười
Phần tử
locator.screenshot()
Một biểu đồ, bảng hoặc biên lai
Tính độc nhất của định vị và sự sẵn sàng của thành phần
Một ảnh chụp toàn trang có thể bao gồm một khu vực tải lười trống nếu ứng dụng chưa bao giờ kết xuất nội dung của nó. Một danh sách ảo chỉ có thể gắn hàng gần viewport hiện tại của nó. Kiểm tra một hàng cụ thể và chụp phần đó riêng biệt khi trang sử dụng ảo hóa. Đối với tiêu đề cố định, các vị trí đã cuộn và trạng thái lớp phủ cần được kiểm soát trước khi chụp. Hướng dẫn ảnh chụp màn hình Playwright.
Mối liên hệ giữa màn hình, viewport và tỷ lệ pixel là gì?
Độ phân giải màn hình mô tả môi trường hiển thị từ xa, viewport mô tả khu vực nội dung trang có sẵn, và kích thước của một PNG phụ thuộc vào phạm vi và tỷ lệ chụp. Resolution Fingerprint của Nstdata kiểm soát màn hình được báo cáo và cửa sổ trình duyệt ban đầu. Chrome trình duyệt có thể giảm khu vực nội dung. Thay đổi kích thước Live View thay đổi đại diện bản xem trước, vì vậy hãy sử dụng kiểm tra phía trình duyệt để xác lập hình học thực tế. Hướng dẫn cấu hình Cloud Browser.
Khi hiệu chỉnh bố cục, hãy làm cho tỷ lệ pixel trở nên rõ ràng. Tỷ lệ CSS cung cấp một pixel hình ảnh cho mỗi pixel CSS. Tỷ lệ thiết bị sử dụng pixel thiết bị và có thể tạo ra một tệp lớn hơn với DPR cao hơn. API Playwright cũng cảnh báo rằng setViewportSize() có thể đặt lại kích thước màn hình của trang. Ghi lại các quan sát sau khi thay đổi viewport. Nếu mục tiêu của bạn là đo các cài đặt quản lý khi khởi động, hãy bỏ qua việc ghi đè đó và ghi lại hình học ban đầu. Tài liệu tham khảo Page.setViewportSize.
Làm thế nào để bạn chụp một trang đầy đủ và một phần tử từ cùng một tác vụ?
Gắn kết với một phiên điều khiển từ xa đã sẵn sàng hoặc chạy một công cụ fixture Chromium cục bộ, sau đó xác nhận một dấu hiệu nội dung đã biết trước khi chụp cả hai phạm vi. Sử dụng Node.js 22.12 hoặc phiên bản mới hơn và playwright-core@1.65.1. Để thực thi cục bộ, trước tiên hãy chạy npx playwright-core install chromium.
Bước 1. Bắt đầu một mục tiêu chụp đã được phê duyệt
Lưu fixture.mjs và bắt đầu nó bằng node fixture.mjs. Mở /report trên loopback. Nó chứa một khu vực đã đặt tên và tải dấu hiệu sẵn sàng của nó không đồng bộ. Đối với một bài kiểm tra đám mây, triển khai cùng một hợp đồng trang đã phê duyệt tại một URL staging có thể truy cập từ trình duyệt từ xa.
Lưu các mô-đun chia sẻ bên dưới. Đối với một phiên chạy được quản lý, hãy chọn không gian làm việc của bạn dưới Cloud Browser → Playground, đặt Resolution Fingerprint ban đầu, và khởi động. Đặt NSTDATA_API_KEY và NSTDATA_SESSION_ID cho một phiên sẵn sàng, với trường đội ngũ tùy chọn khi cần thiết. Một kết nối quản lý phải được thực hiện trong không gian làm việc được ủy quyền của bạn. Các ảnh chụp màn hình và kiểm tra hình học đã được thực hiện trong một cấu trúc Chromium cục bộ. Xem cách kết nối Playwright với trình duyệt từ xa.
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);}
Lưu screenshots.mjs và chạy TARGET_URL=http://127.0.0.1:4173/report node screenshots.mjs trong thư mục chụp của bạn. Đối với một phiên chạy được quản lý, thay thế URL bằng mục tiêu đã được phê duyệt và cung cấp các biến thông tin xác thực của nó. Các tệp ảnh chụp màn hình được ghi bởi công nhân và nên đi vào một thư mục lưu trữ riêng tư.
Đoạn mã này sản xuất một PNG toàn trang và một PNG trong khu vực. Mã kiểm tra kích thước PNG sử dụng bộ đệm đã tạo. Nó khẳng định chiều rộng 960 pixel CSS và báo cáo chiều cao cũng như kích thước thành phần. Các chi tiết bố cục như phông chữ mặc định có thể thay đổi chiều cao đo được. Hãy xác nhận rằng khu vực mong đợi hiện diện một cách trực quan trước khi tuyên bố tính đồng nhất trực quan. Tham chiếu hành vi chụp ảnh phần tử giải thích hành vi chụp phần tử.
[Ảnh chụp màn hình: Báo cáo thử nghiệm đã phê duyệt bên cạnh ảnh chụp toàn trang và ảnh chụp khu vực của nó, không có thông tin tài khoản.]
Bước 4. Điều chỉnh ảnh chụp và kết thúc phiên
Ghi lại giai đoạn, phiên bản ứng dụng, phạm vi ảnh chụp và hình học. Chỉ lưu trữ các hình ảnh cần thiết. Đoạn mã đóng trang và kết nối của chính nó. Kết thúc phiên quản lý ban đầu từ bảng điều khiển hoặc bộ điều khiển sở hữu, sau đó xác minh việc tắt. Xem quản lý vòng đời phiên.
Tại sao ảnh chụp lại khác nhau?
Các ảnh chụp lại khác nhau khi hình học trình duyệt, nội dung, thời gian, phông chữ hoặc môi trường bản vẽ thay đổi. Đầu tiên hãy đảm bảo cả hai hình ảnh đều hiển thị cùng một bản ghi và điểm kiểm tra. Nếu ứng dụng thay đổi dấu thời gian hoặc vị trí quảng cáo trong mỗi yêu cầu, hãy làm cho mẫu trở nên xác định hoặc che giấu phần tử đang thay đổi cụ thể khi thử nghiệm cho phép. Giữ khu vực xung quanh một khiếm khuyết thực tế có thể nhìn thấy.
Triệu chứng
Nguyên nhân khả thi
Kiểm tra thực tiễn
Bảng trống trong PNG hợp lệ
Độ sẵn sàng dữ liệu hoặc phông chữ
Khẳng định nội dung đã biết và chờ các tài sản cần thiết
Kích thước hình ảnh khác nhau
Phạm vi, cửa sổ xem, tỷ lệ hoặc chiều cao cuộn
So sánh hình học đã báo cáo và tùy chọn chụp
Bố cục thay đổi giữa các lần chạy
Phông chữ khác nhau, hệ điều hành, tỷ lệ thiết bị hoặc nội dung
Chạy với một môi trường không thay đổi và đã ghi lại
Ảnh hình phần tử bị thiếu phần
Tình trạng thu gọn, tràn hoặc bản vẽ ảo
Mở trạng thái đã đồng ý và sử dụng một khẳng định hẹp hơn
Lớp phủ không mong muốn xuất hiện
Trạng thái hộp thoại, đồng ý hoặc đăng nhập
Sử dụng trạng thái mẫu đã phê duyệt và xác minh nó một cách rõ ràng
Ngưỡng hồi quy trực quan nên tuân theo độ dung nạp của sản phẩm. Một ảnh chụp màn hình từ một môi trường khác có thể tiết lộ một lỗi hữu ích nhưng không nên tự động thay thế một tham chiếu. Chụp một thành công đã biết, sau đó tái tạo sự thất bại cố ý tại cùng một cửa sổ xem. hướng dẫn so sánh trực quan Playwright.
Làm thế nào để bạn làm cho ảnh chụp màn hình có thể so sánh giữa các bản phát hành?
Làm cho các ảnh chụp màn hình bản phát hành có thể so sánh bằng cách lưu trữ các điều kiện thử nghiệm cùng với cơ sở dữ liệu. Sử dụng cùng dữ liệu mẫu, phiên bản trình duyệt, phông chữ đã phê duyệt, cửa sổ xem, tỷ lệ và phạm vi chụp. Giữ các kiểm tra hình ảnh tại các điểm kiểm tra được đặt tên thay vì chụp mọi trạng thái trung gian. Nếu một báo cáo sử dụng ngày động, xác định một ngày cố định trong mẫu và khẳng định nó trước khi chụp.
Đối với một thất bại trực quan không liên tục, hãy lưu lại hình ảnh nhỏ nhất vẫn chứa khiếm khuyết và một hình ảnh ngữ cảnh toàn trang chỉ khi cần thiết. So sánh kích thước trước. Nếu chiều cao tài liệu thay đổi vì một tập dữ liệu lọc có nhiều hàng hơn, sự khác biệt pixel có thể là triệu chứng của đầu vào đã thay đổi. Kiểm tra số lượng dữ liệu đã vẽ và mẫu mong đợi trước khi thay thế hình ảnh tham chiếu.
Nstdata Cloud Browser hỗ trợ quy trình làm việc chụp 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. Nó cho phép người sử dụng kết nối với một trình duyệt đang chạy và ghi lại trạng thái trang được tạo ra bởi các hành động đã được phê duyệt của chính họ. Proxy đã cấu hình có thể định tuyến một bài kiểm tra khu vực mà không cần cấu hình proxy riêng trong khách hàng đó. Live View giúp người vận hành xác nhận những gì trình duyệt đang chạy hiển thị. Bài kiểm tra của bạn vẫn quyết định khu vực nào để ghi lại và bằng chứng nào để giữ lại.
Thực thi CDP. Giữ nguyên các khẳng định Playwright và các thao tác ghi lại bên trong trình duyệt từ xa.
Lựa chọn môi trường. Cấu hình màn hình ban đầu dự định và kiểm tra viewport thực tế trong trang.
Quan sát trực tiếp. Liên kết một hình ảnh với trang trực tiếp, Console hoặc bằng chứng Mạng nếu việc ghi lại chưa hoàn tất.
Điều gì cần đứng cạnh ảnh chụp màn hình cuối cùng?
Lưu trữ một bảng kê ngắn với trường hợp kiểm tra, tuyến đường nguồn đã được phê duyệt, dấu thời gian, viewport, DPR, phạm vi, dấu hiệu mong đợi và phán quyết kiểm tra. Làm sạch nội dung đã ghi lại trước khi gửi một hiện vật ra ngoài khán giả được ủy quyền. Giữ lại ID Phiên được quản lý trong siêu dữ liệu công việc riêng tư để một nhà phát triển có thể khắc phục sự cố trước khi lịch sử liên quan hết hạn. Tham khảo Hướng dẫn Tự động hóa Trình duyệt Đám mây khi tích hợp ghi lại và tắt nguồn.
Q: Ảnh chụp màn hình toàn trang có tải mọi phần tử chậm không?
Xác minh các phần tử cần thiết một cách rõ ràng. Việc ghi lại toàn trang bao phủ phạm vi đã hiển thị của tài liệu, có thể bao gồm các phần mà dữ liệu của chúng chưa được tải.
Q: Tại sao hình ảnh lại hẹp hơn màn hình đã cấu hình?
Kiểm tra viewport nội dung và tỷ lệ CSS. Chrome của trình duyệt hoặc một ghi đè viewport rõ ràng có thể thay đổi diện tích có sẵn cho trang.
Q: Tôi có cần sử dụng một khoảng thời gian cố định trước khi ghi lại không?
Ưu tiên một dấu hiệu sẵn sàng có ý nghĩa. Thêm các kiểm tra phông chữ hoặc tài nguyên cụ thể khi các tài sản đó là một phần của bằng chứng.
Q: Liệu phát lại phiên có thay thế ảnh chụp màn hình kiểm tra thị giác không?
Sử dụng so sánh ảnh chụp màn hình cho bằng chứng pixel. Phát lại DOM đã lưu trữ hỗ trợ chẩn đoán trình tự và có thể hiển thị các phông chữ hoặc hình ảnh khác nhau.
Q: Playwright có lưu ảnh chụp màn hình trong hệ thống tệp của trình duyệt đám mây không?
Đường dẫn ảnh chụp màn hình trong ví dụ này thuộc về người gọi Node.js. Áp dụng các kiểm soát truy cập và bảo trì đối với thư mục hiện vật của nó.
Marcus Chen
Nov. 19th 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.