Utilitas

Random

Masukan	min, max (angka), seed
Keluaran	result

op	Mengembalikan
int	Sebuah bilangan bulat antara min dan max
float	Sebuah bilangan pecahan
string	Sebuah string sepanjang length karakter
boolean	Sebuah boolean
pick	Sebuah elemen yang diambil dari items

Kolom seed (sebuah angka atau string) membuat pengambilannya deterministik: inilah yang memungkinkan data yang beragam tetapi pengujian yang dapat direproduksi. Itulah perbedaan mendasarnya dengan helper {{$random…}}, yang tidak pernah dapat direproduksi.

Schema validate

Masukan	value, schema (string)
Keluaran	valid, invalid, errors
Konfigurasi	schema — sebuah JSON Schema, dalam draft-07, 2019-09, atau 2020-12

Alat pilihan untuk memastikan sebuah respons mematuhi kontraknya. Sambungkan errors ke sebuah Log: keluarannya merinci setiap pelanggaran, sehingga sebuah kegagalan CI langsung dapat dimanfaatkan.

Permintaan HTTP ──response[body]──► Schema validate
                                       ├─ valid   ──► (lanjutannya)
                                       ├─ invalid ──► Throw
                                       └─ errors  ──► Log

Read file

Masukan	path (string)
Keluaran	content (string)
Konfigurasi	path — absolut, atau relatif terhadap file .restorm yang terbuka

Jalur relatif adalah yang sebaiknya dipakai agar skenarionya tetap portabel antara mesin Anda dan CI.

Write file

Masukan	path (string), content
Keluaran	tidak ada
Konfigurasi	path, mode: replace (bawaan) atau append

Log

Masukan	message (string), data
Keluaran	tidak ada
Konfigurasi	level: debug, info, warn, error

Inilah satu-satunya kotak keterlacakan. Entrinya adalah satu-satunya yang ditampilkan secara bawaan di dalam log eksekusi dan pada keluaran baris perintah — entri mesinnya hanya ditambahkan dengan --all-logs.

Dengan kata lain: apa yang Anda tulis dengan Log adalah apa yang akan Anda temukan kembali di dalam artefak CI Anda.

Assert (asersi)

Masukan	a (nilai yang diamati), b (nilai yang diharapkan), message (string)
Keluaran	then (berhasil), else (gagal)
Konfigurasi	operator, a, b, message

Operator yang tersedia:

eq · ne · lt · lte · gt · gte · contains · isString · isNumber · isBoolean · isArray · isObject · isNull · exists · isEmpty · matchesRegex · isOneOf · deepEquals · lengthEq · lengthGt · lengthLt

Kolom message adalah yang akan membuat kegagalannya mudah dipahami di dalam lognya: tuliskan di sana apa yang diharapkan, bukan sekadar “galat”.

Throw (melempar galat)

Masukan	message (string)
Keluaran	tidak ada — kotak ini tidak memiliki port done
Konfigurasi	message

Menggagalkan eksekusinya dengan sengaja. Inilah yang menghasilkan kode keluar 1 di CI: sambungkan ke keluaran else milik asersi kritis Anda atau ke invalid milik sebuah validasi skema.