takeScreenshot

Chụp ảnh màn hình và lưu vào thư mục kết quả test.

Command takeScreenshot lưu ảnh chụp màn hình hiện tại thành file PNG.

Tham số

Command takeScreenshot nhận tham số path:

Parameter	Mô tả
path	Tên file của ảnh chụp màn hình, không có phần mở rộng. Có thể gồm thư mục con. Xem Đường dẫn artifact để biết nơi lưu.
cropOn	Không bắt buộc. Selector để thu hẹp ảnh chụp vào đúng phần tử hoặc container bạn quan tâm. Thường dùng với assertScreenshot. Danh sách đầy đủ các selector xem ở tài liệu Selectors.
label	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

Ví dụ sau lưu ảnh chụp màn hình thành LoginScreen.png.

- takeScreenshot:
    path: LoginScreen

Ví dụ tiếp theo cũng là màn hình đăng nhập đó, nhưng cắt vào vùng chứa các điều khiển đăng nhập

- takeScreenshot:
    path: LoginScreen
    cropOn:
      id: LoginFormContainer
    label: Take a screenshot of the login form

Bạn cũng có thể dùng cú pháp viết tắt. Ví dụ sau lưu ảnh chụp màn hình thành MainScreen.png.

- takeScreenshot: MainScreen

Bạn cũng có thể nhóm các ảnh chụp màn hình vào thư mục con của thư mục artifact.

- takeScreenshot:
    path: checkout/PaymentScreen

Đường dẫn artifact

Astra Scout ghi đầu ra của command này vào thư mục takeScreenshot trong gói artifact của flow. Xem thư mục artifact của run trong báo cáo.

path phải chỉ tới một file, và không được cố thoát khỏi thư mục artifact. Astra Scout từ chối command với error Invalid path (và flow fail) nếu giá trị:

• chỉ tới một thư mục thay vì file
• đi ra ngoài thư mục đầu ra của command bằng .., như ../escape
• là chuỗi rỗng, xảy ra khi một biến trong đường dẫn cho ra ""

Đường dẫn tuyệt đối được phép miễn là vẫn trỏ đúng thư mục.

Một biến chưa từng được định nghĩa không làm command fail. Nó cho ra undefined, và ảnh chụp màn hình được lặng lẽ ghi vào undefined.png.

Nếu không ghi được file (ví dụ đầy ổ đĩa hoặc đích chỉ đọc), flow fail với Cannot write takeScreenshot output to ....