Verktøy

Random


Inndata	`min`, `max` (tall), `seed`
Utdata	`result`

`op`	Returnerer
`int`	Et heltall mellom `min` og `max`
`float`	Et flyttall
`string`	En streng på `length` tegn
`boolean`	En boolsk verdi
`pick`	Et element trukket fra `items`

Feltet seed (et tall eller en streng) gjør trekningen deterministisk: det er dette som lar deg ha varierte data og likevel en reproduserbar test. Det er den vesentlige forskjellen fra {{$random…}}-helperne, som aldri er reproduserbare.

Schema validate


Inndata	`value`, `schema` (streng)
Utdata	`valid`, `invalid`, `errors`
Konfigurasjon	`schema` — et JSON Schema, i draft-07, 2019-09 eller 2020-12

Det foretrukne verktøyet for å kontrollere at et svar overholder kontrakten sin. Koble errors til en Log: utdataene beskriver hvert brudd i detalj, noe som gjør en CI-feil direkte anvendelig.

HTTP-forespørsel ──response[body]──► Schema validate
                                        ├─ valid   ──► (fortsettelsen)
                                        ├─ invalid ──► Throw
                                        └─ errors  ──► Log

Read file


Inndata	`path` (streng)
Utdata	`content` (streng)
Konfigurasjon	`path` — absolutt, eller relativ til den åpne `.restorm`-filen

Den relative stien er den du bør bruke for at scenarioet skal holde seg portabelt mellom maskinen din og CI-en.

Write file


Inndata	`path` (streng), `content`
Utdata	ingen
Konfigurasjon	`path`, `mode`: `replace` (standard) eller `append`

Log (logg)


Inndata	`message` (streng), `data`
Utdata	ingen
Konfigurasjon	`level`: `debug`, `info`, `warn`, `error`

Dette er den boksen for sporbarhet. Oppføringene fra den er de eneste som vises som standard i kjøringsloggen og på utdataene fra kommandolinjen — oppføringene fra motoren kommer bare til med --all-logs.

Med andre ord: det du skriver med Log, er det du finner igjen i artefaktene fra CI-en din.

Assert (assertion)


Inndata	`a` (observert verdi), `b` (forventet verdi), `message` (streng)
Utdata	`then` (bestått), `else` (feilet)
Konfigurasjon	`operator`, `a`, `b`, `message`

Tilgjengelige 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 som gjør feilen forståelig i loggen: skriv der hva som var forventet, ikke «feil».

Throw (kaste en feil)


Inndata	`message` (streng)
Utdata	ingen — denne boksen har ingen `done`-port
Konfigurasjon	`message`

Lar kjøringen feile med vilje. Det er dette som gir exit-kode 1 i CI: koble den til else-utgangen på de kritiske assertionene dine, eller til invalid fra en skjemavalidering.