assertScreenshot

Kiểm thử hồi quy trực quan của app so với các ảnh chụp có sẵn.

Command assertScreenshot chụp ảnh màn hình và so khớp với một ảnh chuẩn đã biết, thực hiện test hồi quy giao diện.

Assertion fail nếu ảnh so sánh quá khác biệt, hoặc không tồn tại.

Cú pháp

- assertScreenshot: splash.png

hoặc

- assertScreenshot:
    path: screen.png
    cropOn:
      id: banner
    thresholdPercentage: 98

Tham số

Parameter	Type	Mô tả
path	String	Đường dẫn tới ảnh chụp màn hình chuẩn mà màn hình hiện tại được so sánh với. Có thể là biểu thức JavaScript. Thường được tạo bởi một lệnh takeScreenshot ở run trước.
cropOn	Element Selector	Không bắt buộc. Selector để thu hẹp ảnh chụp trước khi so sánh. Ảnh so sánh cũng phải được cắt tương tự. Danh sách đầy đủ các selector xem ở tài liệu Selectors.
thresholdPercentage	Number	Không bắt buộc. Phần trăm khớp cần có để assertion này qua. Mặc định là 95. Có thể là biến hoặc biểu thức JavaScript, miễn là kết quả là một số.
label	String	Không bắt buộc. Thông điệp hiển thị khi thực hiện đánh giá.

Ví dụ sử dụng

Kiểm tra so với ảnh chụp màn hình chuẩn

Ví dụ này so sánh màn hình hiện tại với splash.png, dùng ngưỡng mặc định 95%.

- assertScreenshot: splash.png

Đặt ngưỡng từ một biến

Ngưỡng được nội suy trước khi so sánh chạy, nên bạn có thể tinh chỉnh theo môi trường hoặc device mà không cần sửa flow.

appId: com.example.app
env:
  THRESHOLD_PERCENTAGE: 80
---
- assertScreenshot:
    path: ./screenshot.png
    thresholdPercentage: ${THRESHOLD_PERCENTAGE}

Thông tin

Giá trị phải cho ra một số. Nếu kết quả là thứ khác, ví dụ chuỗi rỗng do biến chưa được đặt, assertion fail với Invalid thresholdPercentage for assertScreenshot thay vì dùng giá trị mặc định.