runScript

Chạy một file JavaScript bên ngoài và lấy kết quả đầu ra.

Command runScript chạy một file JavaScript chỉ định. Script có thể truy cập biến môi trường và đặt các giá trị output cho các command tiếp theo trong flow.

Tham số

Command runScript nhận một chuỗi chỉ đường dẫn file, hoặc một map chứa đường dẫn file và biến môi trường.

Key	Mô tả
file	Đường dẫn tới file JavaScript cần chạy. Có thể là đường dẫn tuyệt đối hoặc tương đối so với file flow.
env	(Không bắt buộc) Map các cặp key-value truyền cho script dưới dạng biến môi trường.

Ví dụ sử dụng

Các ví dụ sau minh họa cách dùng command runScript.

Chạy cơ bản

Dùng runScript với đường dẫn file để chạy một script. Script có thể truy cập các biến env định nghĩa sẵn trong flow và đặt giá trị output để dùng sau.

File flow

appId: com.example
env:
    MY_NAME: John
---
- launchApp
- runScript: myScript.js
- inputText: ${output.uppercaseName}

File JavaScript (myScript.js)

var uppercaseName = MY_NAME.toUpperCase()

output.uppercaseName = uppercaseName   // returns 'JOHN'

Trong ví dụ này, flow mở app rồi chạy một file JavaScript bên ngoài bằng runScript. Script đọc biến môi trường MY_NAME khai báo trong flow, chuyển thành chữ hoa và lưu kết quả vào output.uppercaseName. Giá trị output đó sau đó được dùng ở step kế tiếp để nhập text "JOHN" vào app.

Đường dẫn file

Đường dẫn có thể là tương đối hoặc tuyệt đối.

Đường dẫn tương đối được tính từ vị trí của flow gọi, không phải từ thư mục nơi command được chạy.

Với cấu trúc thư mục sau:

├── flows
│   └── test.yaml
└── scripts
    └── uppercase.js

Flow test.yaml phải dùng đường dẫn tương đối để tham chiếu uppercase.js:

appId: com.example
env:
    MY_NAME: John
---
- launchApp
- runScript: ../scripts/uppercase.js

Truyền tham số

Để truyền tham số trực tiếp cho script, dùng cú pháp map mở rộng với key env.

- runScript:
    file: script.js
    env:
       myParameter: 'Parameter'

Ghi log ra console

runScript chuyển mọi đầu ra console.log() từ file JavaScript vào log của run.

Nội dung liên quan

• Tổng quan JavaScript: Bắt đầu tìm hiểu cách dùng JavaScript trong test.
• JavaScript output: Tìm hiểu cách lưu và dùng output JavaScript trong flow.
• Parameters: Tìm hiểu cách định nghĩa và dùng tham số trong flow để tái sử dụng.
• Constants: Tìm hiểu cách định nghĩa giá trị hằng và dùng lại trong các flow.
• Nested flows: Tìm hiểu cách ghép flow bằng cách gọi flow này từ flow khác.
• Conditional execution: Tìm hiểu cách điều khiển việc chạy flow bằng điều kiện và logic rẽ nhánh.