Hjælpeværktøjer

Random (tilfældig)

Indgange	min, max (tal), seed
Udgange	result

op	Sender tilbage
int	Et helt tal mellem min og max
float	Et decimaltal
string	En streng på length tegn
boolean	En boolean
pick	Et element trukket fra items

Feltet seed (et tal eller en streng) gør udtrækningen deterministisk: det er det, der giver dig varierede data og alligevel en reproducerbar test. Det er den væsentlige forskel fra {{$random…}}-helperne, som aldrig er reproducerbare.

Schema validate (skemavalidering)

Indgange	value, schema (streng)
Udgange	valid, invalid, errors
Konfiguration	schema — et JSON Schema i draft-07, 2019-09 eller 2020-12

Værktøjet frem for alt til at kontrollere, at et svar overholder sin kontrakt. Forbind errors til en Log: outputtet beskriver hver overtrædelse i detaljer, og det gør en fejl i CI direkte anvendelig.

HTTP-anmodning ──response[body]──► Schema validate
                                      ├─ valid   ──► (fortsættelsen)
                                      ├─ invalid ──► Throw
                                      └─ errors  ──► Log

Read file (læs fil)

Indgange	path (streng)
Udgange	content (streng)
Konfiguration	path — absolut eller relativ til den åbne .restorm-fil

Den relative sti er den, du skal bruge, hvis scenariet skal blive ved med at være portabelt mellem din egen maskine og CI.

Write file (skriv fil)

Indgange	path (streng), content
Udgange	ingen
Konfiguration	path, mode: replace (standard) eller append

Log

Indgange	message (streng), data
Udgange	ingen
Konfiguration	level: debug, info, warn, error

Det er selve boksen til sporbarhed. Dens poster er de eneste, der som standard bliver vist i kørselsloggen og på outputtet fra kommandolinjen — motorens egne poster kommer først med, når du bruger --all-logs.

Med andre ord: hvad du skriver med Log, er det, du finder igen i din CI’s artefakter.

Assert (assertion)

Indgange	a (den observerede værdi), b (den forventede værdi), message (streng)
Udgange	then (bestået), else (fejlet)
Konfiguration	operator, a, b, message

Tilgængelige operatorer:

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

Feltet message er det, der gør fejlen forståelig i loggen: skriv, hvad der var forventet, ikke »fejl«.

Throw (kast en fejl)

Indgange	message (streng)
Udgange	ingen — denne boks har ingen done-port
Konfiguration	message

Lader kørslen fejle med vilje. Det er det, der giver exitkode 1 i CI: forbind den til else-udgangen på dine kritiske assertioner eller til invalid fra en skemavalidering.