Hulpmiddelen

Random

Invoer	min, max (getallen), seed
Uitvoer	result

op	Geeft terug
int	Een geheel getal tussen min en max
float	Een kommagetal
string	Een tekenreeks van length tekens
boolean	Een boolean
pick	Een element dat uit items wordt getrokken

Het veld seed (een getal of een tekenreeks) maakt de trekking deterministisch: daarmee hebt u gevarieerde gegevens en toch een reproduceerbare test. Dat is het wezenlijke verschil met de {{$random…}}-helpers, die nooit reproduceerbaar zijn.

Schema validate

Invoer	value, schema (tekenreeks)
Uitvoer	valid, invalid, errors
Configuratie	schema — een JSON Schema, in draft-07, 2019-09 of 2020-12

Het middel bij uitstek om te controleren dat een respons zijn contract nakomt. Sluit errors op een Log aan: de uitvoer beschrijft elke overtreding, waardoor een CI-mislukking direct bruikbaar is.

HTTP-verzoek ──response[body]──► Schema validate
                                    ├─ valid   ──► (vervolg)
                                    ├─ invalid ──► Throw
                                    └─ errors  ──► Log

Read file

Invoer	path (tekenreeks)
Uitvoer	content (tekenreeks)
Configuratie	path — absoluut, of relatief aan het geopende .restorm-bestand

Het relatieve pad is wat u moet gebruiken om het scenario overdraagbaar te houden tussen uw eigen machine en de CI.

Write file

Invoer	path (tekenreeks), content
Uitvoer	geen
Configuratie	path, mode: replace (standaard) of append

Log (logboek)

Invoer	message (tekenreeks), data
Uitvoer	geen
Configuratie	level: debug, info, warn, error

Dit is hét vakje voor traceerbaarheid. De items daarvan zijn de enige die standaard in het uitvoeringslogboek en op de uitvoer van de opdrachtregel worden weergegeven — de items van de engine komen er alleen bij met --all-logs.

Met andere woorden: wat u met Log schrijft, is wat u in de artefacten van uw CI terugvindt.

Assert (assertie)

Invoer	a (de waargenomen waarde), b (de verwachte waarde), message (tekenreeks)
Uitvoer	then (geslaagd), else (mislukt)
Configuratie	operator, a, b, message

De beschikbare operatoren:

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

Het veld message is wat de mislukking in het logboek begrijpelijk maakt: schrijf er dus in wat u verwachtte, niet “fout”.

Throw (een fout werpen)

Invoer	message (tekenreeks)
Uitvoer	geen — dit vakje heeft geen done-poort
Configuratie	message

Laat de uitvoering met opzet mislukken. Dat is wat in CI een afsluitcode 1 oplevert: sluit het aan op de uitvoer else van uw kritieke asserties of op invalid van een schemavalidatie.