Verktyg

Random


Ingångar	`min`, `max` (tal), `seed`
Utgångar	`result`

`op`	Returnerar
`int`	Ett heltal mellan `min` och `max`
`float`	Ett flyttal
`string`	En sträng på `length` tecken
`boolean`	En boolesk
`pick`	Ett element draget ur `items`

Fältet seed (ett tal eller en sträng) gör dragningen deterministisk: det är det som ger varierade data men ett reproducerbart test. Det är den väsentliga skillnaden mot helpers {{$random…}}, som aldrig är reproducerbara.

Schema validate


Ingångar	`value`, `schema` (sträng)
Utgångar	`valid`, `invalid`, `errors`
Konfiguration	`schema` — ett JSON Schema, i draft-07, 2019-09 eller 2020-12

Verktyget att välja för att kontrollera att ett svar följer sitt kontrakt. Koppla errors till en Log: utmatningen beskriver varje överträdelse i detalj, vilket gör ett CI-misslyckande direkt användbart.

HTTP-begäran ──response[body]──► Schema validate
                                    ├─ valid   ──► (fortsättning)
                                    ├─ invalid ──► Throw
                                    └─ errors  ──► Log

Read file


Ingångar	`path` (sträng)
Utgångar	`content` (sträng)
Konfiguration	`path` — absolut, eller relativ till den öppnade `.restorm`-filen

Den relativa sökvägen är den du ska använda för att scenariot ska förbli portabelt mellan din maskin och CI.

Write file


Ingångar	`path` (sträng), `content`
Utgångar	inga
Konfiguration	`path`, `mode`: `replace` (standard) eller `append`

Log (logg)


Ingångar	`message` (sträng), `data`
Utgångar	inga
Konfiguration	`level`: `debug`, `info`, `warn`, `error`

Det här är den ruta som ger spårbarhet. Dess poster är de enda som visas som standard i körningsloggen och i utmatningen från kommandoraden — motorns poster läggs bara till med --all-logs.

Med andra ord: det du skriver med Log är det du kommer att hitta igen i din CI:s artefakter.

Assert (assertion)


Ingångar	`a` (observerat värde), `b` (förväntat värde), `message` (sträng)
Utgångar	`then` (lyckat), `else` (misslyckat)
Konfiguration	`operator`, `a`, `b`, `message`

Tillgängliga operatorer:

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

Fältet message är det som gör misslyckandet begripligt i loggen: skriv där vad som förväntades, inte ”fel”.

Throw (kasta ett fel)


Ingångar	`message` (sträng)
Utgångar	inga — den här rutan har ingen port `done`
Konfiguration	`message`

Får körningen att misslyckas avsiktligt. Det är det som ger slutkod 1 i CI: koppla den till utgången else i dina kritiska assertions eller till invalid i en schemavalidering.