Skripte, Tests und Runner
RequestTailor führt Skripte in einer Sandbox aus: vor dem Request, nach der Antwort und als Tests. Assertions prüfen Status, Header und Body ohne eine Zeile JavaScript. Der Runner schickt einen Ordner oder die ganze Collection nacheinander, auch mehrfach und mit einer Datendatei – und rt run macht dasselbe in der Pipeline, mit denselben Ergebnissen.
- Edition
- Free
- Wo
- Tabs Scripts und Assertions des Requests; Run im Kopf
- Engine
- QuickJS als WebAssembly, Sandbox
- Grenzen
- 5 s je Phase, 64 MiB Speicher (Standard)
- Pipeline
rt run, Exit-Code 4 bei Fehlschlag
Drei Phasen: Pre-request, Post-response, Tests
Der Tab Scripts eines Requests hat drei Felder. Jedes ist optional; die Zahl am Tab zeigt, wie viele gefüllt sind.

- Pre-request läuft vor dem Senden. Es darf den Request ändern (URL, Header, Body) und Variablen setzen; was es setzt, landet in der Laufzeit-Ebene und gilt schon für diesen Request.
- Post-response läuft nach der Antwort, etwa um ein Token aus dem Body für die nächsten Requests zu merken.
- Tests läuft zuletzt. Jeder
test("…", () => …)erscheint mit Name und Ergebnis im Tab Tests der Antwort.
Skripte gibt es auch auf Ordner- und Collection-Ebene. Sie laufen in dieser Reihenfolge: Collection, Ordner von außen nach innen, Request. Alle Skripte einer Phase teilen sich einen Gültigkeitsbereich; jede Phase beginnt frisch.
// Pre-request: Zeitstempel als Variable
rt.vars.set("requestedAt", new Date().toISOString());
// Post-response: Token für die Sitzung merken
rt.vars.set("token", rt.response.json().access_token);
// Tests
test("status is 200", () => {
expect(rt.response.status).to.equal(200);
});
Die API heißt rt: rt.request, rt.response, rt.vars, rt.info, rt.sendRequest, rt.sleep und rt.runner, dazu test, expect (die gängigen chai-Wörter) und console. Die vollständigen Typen stehen in crates/rt-script/api.d.ts im Repo des Kerns.
Vertrauen: Skripte laufen nur, wenn du es erlaubst
Eine Collection aus einem fremden Repo kann Skripte enthalten. Deshalb fragt RequestTailor einmal je Collection und Gerät. Über der Oberfläche erscheint „This collection contains scripts. Run them?“ mit Trust and run scripts und Not now.
- Bis du vertraust, wird ohne Skripte gesendet; der Report trägt dann einen Warnhinweis.
- Not now blendet die Frage für diese Collection bis zum nächsten Start aus.
- Assertions laufen immer: Sie sind kein JavaScript, sondern werden im Kern ausgewertet.
Variablen aus Skripten
rt.vars.set(name, wert, ebene) schreibt in eine Ebene: runtime (Standard), environment, collection oder global. Gesetzt wird nur im Speicher: in der App für die Sitzung der gewählten Umgebung, im Runner und in rt run für den Lauf. Dateien schreibt ein Skript nie – die Dateien im Repo bleiben die Wahrheit.
Werte sind Zeichenketten. Zahlen, Wahrheitswerte und Objekte werden als JSON gespeichert; in derselben Phase liest das Skript den Wert mit Typ zurück, später als Text. Variablen der Sitzung zeigt und löscht der Knopf Session variables.
Assertions ohne JavaScript
Der Tab Assertions prüft die Antwort deklarativ: Expression, Operator, Value. Ausdrücke sind etwa res.status, res.headers.name, res.responseTime oder ein Pfad in den Body wie res.body.items[0].id.
| Gruppe | Operatoren |
|---|---|
| Vergleich | eq, neq, gt, gte, lt, lte, between |
| Listen und Text | in, notIn, contains, notContains, length, matches, notMatches, startsWith, endsWith |
| Ohne Wert | isEmpty, isNotEmpty, isNull, isUndefined, isDefined, isTruthy, isFalsy, isJson, isNumber, isString, isBoolean, isArray |
Die Operatoren sind die von Bruno, in Brunos Reihenfolge; Bruno-Assertions laufen also unverändert. Unter Variables from the response legst du außerdem Variablen aus der Antwort an, ebenfalls ohne Skript.
Postman-, Bruno- und Insomnia-Skripte
Importierte Skripte bleiben, wie sie sind. bru.*, req, res, pm.*, postman.* und insomnia.* laufen als Shims auf der rt-API.2 Dazu kommen eingebaute Module für require: crypto-js (Hashes, HMAC, PBKDF2, ohne Verschlüsselung), lodash (rund 130 Funktionen), moment (ohne Zeitzonen), uuid (v4), chai, tv4, ajv, atob/btoa.
Was es nicht gibt, meldet ein klarer Fehler statt eines nichtssagenden TypeError, und der Verlustbericht des Imports nennt jede nicht unterstützte API mit dem Request, in dem sie steht. Die wichtigsten Unterschiede:
- Kein Node.js: kein
fs,path,Buffer,processoderfetch. bru.setEnvVar(…, { persist: true })und Postmans Umgebungs-Schreibzugriffe ändern keine Dateien.setTimeoutundbru.sleeplaufen aufrt.sleepund zählen gegen die Zeitgrenze.- gRPC- und WebSocket-Skripte von Bruno (
bru.grpc,onMessage) laufen nicht.
Die vollständige Liste mit Status je API steht in crates/rt-script/SHIM-COVERAGE.md im Repo des Kerns.
Der Runner
Der Runner schickt alle Requests eines Ordners oder der Collection nacheinander: Ordner und Requests nach ihrer Reihenfolge (seq), dann nach Name, Ordner zuerst in die Tiefe. Variablen, die Skripte setzen, gelten für die folgenden Requests des Laufs.

- Im Kopf auf Run klicken (die ganze Collection) oder am Ordner auf dessen Run-Knopf; in der Befehlspalette (Mod+K) heißt der Eintrag Run collection.
- Bei Bedarf Iterations, Delay (ms) und Stop at the first failure setzen. Die Umgebung ist die oben gewählte.
- Für datengetriebene Läufe über Data file… eine CSV-Datei (Kopfzeile, dann eine Zeile je Iteration) oder eine JSON-Datei (Liste von Objekten) wählen. Jede Zeile wird zu Variablen ihrer Iteration.
- Den Lauf starten. Jede Zeile zeigt Methode, Name, Status, Zeit und bestandene Tests; ein Klick auf eine Zeile zeigt unten Request und Testergebnisse.
Skripte steuern den Lauf mit rt.runner.skip() (diesen Request auslassen) und rt.runner.setNext(name) (mit einem anderen Request weitermachen; null beendet den Lauf).
In der Pipeline: rt run
rt run nutzt denselben Kern, dieselben Skripte, Plugins und Auth wie die Apps. Was in der App grün ist, ist in der Pipeline grün.3
rt run api/users -e Staging --var token=$API_TOKEN
rt run . --data users.csv --reporter junit=reports/junit.xml --reporter json=reports/run.json
| Option | Bedeutung |
|---|---|
--data FILE | CSV oder JSON; jede Zeile eine Iteration |
--iterations N | Die Requests N-mal ausführen |
--delay MS | Pause zwischen Requests |
--bail | Beim ersten Fehlschlag aufhören |
--reporter NAME[=FILE] | text, json oder junit, mehrfach möglich |
--no-scripts | Ohne Skripte; Assertions laufen weiter |
--no-prompt | Ein OAuth-2.0-Ablauf, der einen Menschen braucht, scheitert statt zu warten |
Exit-Code 4 heißt: Ein Request, ein Test oder eine Assertion ist gescheitert. 0 heißt alles bestanden – ein HTTP 500 ohne Test gilt als bestanden. Secrets kommen als Variablen des CI-Jobs über --var, nie in die Collection. Für GitHub gibt es eine Action, für GitLab und andere ein Docker-Image; Beispiele stehen in Kommandozeile rt.
Siehe auch
- Funktionen im Überblick Funktionen · Tests
- Doku Kommandozeile rt
- Doku Import
- Doku Umgebungen und Variablen
- Belege api.d.ts1 · SHIM-COVERAGE.md2 · rt-cli/README.md3