Βοηθητικά

Τυχαίο


Είσοδοι	`min`, `max` (αριθμοί), `seed`
Έξοδοι	`result`

`op`	Επιστρέφει
`int`	Έναν ακέραιο ανάμεσα στα `min` και `max`
`float`	Έναν δεκαδικό
`string`	Μια συμβολοσειρά με `length` χαρακτήρες
`boolean`	Μια λογική τιμή
`pick`	Ένα στοιχείο τραβηγμένο από το `items`

Το πεδίο seed (ένας αριθμός ή μια συμβολοσειρά) κάνει την κλήρωση ντετερμινιστική: αυτό επιτρέπει να έχετε ποικίλα δεδομένα αλλά μια αναπαραγώγιμη δοκιμή. Είναι η ουσιώδης διαφορά από τους βοηθούς {{$random…}}, που δεν είναι ποτέ αναπαραγώγιμοι.

Επικύρωση σχήματος


Είσοδοι	`value`, `schema` (συμβολοσειρά)
Έξοδοι	`valid`, `invalid`, `errors`
Διαμόρφωση	`schema` — ένα JSON Schema, σε draft-07, 2019-09 ή 2020-12

Το κατεξοχήν εργαλείο για να ελέγξετε ότι μια απόκριση τηρεί το συμβόλαιό της. Συνδέστε τη θύρα errors σε ένα Log: η έξοδος περιγράφει αναλυτικά κάθε παράβαση, πράγμα που κάνει μια αποτυχία CI άμεσα αξιοποιήσιμη.

Αίτημα HTTP ──response[body]──► Επικύρωση σχήματος
                                   ├─ valid   ──► (συνέχεια)
                                   ├─ invalid ──► Throw
                                   └─ errors  ──► Log

Ανάγνωση αρχείου


Είσοδοι	`path` (συμβολοσειρά)
Έξοδοι	`content` (συμβολοσειρά)
Διαμόρφωση	`path` — απόλυτη, ή σχετική ως προς το ανοιχτό αρχείο `.restorm`

Η σχετική διαδρομή είναι αυτή που πρέπει να χρησιμοποιείτε ώστε το σενάριο να παραμένει φορητό ανάμεσα στο μηχάνημά σας και το CI.

Εγγραφή αρχείου


Είσοδοι	`path` (συμβολοσειρά), `content`
Έξοδοι	καμία
Διαμόρφωση	`path`, `mode`: `replace` (προεπιλογή) ή `append`

Log (αρχείο καταγραφής)


Είσοδοι	`message` (συμβολοσειρά), `data`
Έξοδοι	καμία
Διαμόρφωση	`level`: `debug`, `info`, `warn`, `error`

Είναι το κουτί της ιχνηλασιμότητας. Οι καταχωρίσεις του είναι οι μόνες που εμφανίζονται εξ ορισμού στο αρχείο καταγραφής εκτέλεσης και στην έξοδο της γραμμής εντολών — οι καταχωρίσεις της μηχανής προστίθενται μόνο με το --all-logs.

Με άλλα λόγια: ό,τι γράφετε με το Log είναι ό,τι θα βρείτε ξανά στα τεχνουργήματα του CI σας.

Assert (ισχυρισμός)


Είσοδοι	`a` (η παρατηρούμενη τιμή), `b` (η αναμενόμενη τιμή), `message` (συμβολοσειρά)
Έξοδοι	`then` (επιτυχία), `else` (αποτυχία)
Διαμόρφωση	`operator`, `a`, `b`, `message`

Διαθέσιμοι τελεστές:

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

Το πεδίο message είναι αυτό που θα κάνει την αποτυχία κατανοητή μέσα στο αρχείο καταγραφής: γράψτε εκεί τι περιμέναμε, όχι «σφάλμα».

Throw (πρόκληση σφάλματος)


Είσοδοι	`message` (συμβολοσειρά)
Έξοδοι	καμία — αυτό το κουτί δεν έχει θύρα `done`
Διαμόρφωση	`message`

Προκαλεί σκόπιμα αποτυχία της εκτέλεσης. Αυτό δίνει κωδικό εξόδου 1 σε CI: συνδέστε το στην έξοδο else των κρίσιμων ισχυρισμών σας ή στη θύρα invalid μιας επικύρωσης σχήματος.