RequestTailor Vorschau (22.11.2026): Requests als Dateien in Git, ohne Konto, offline – auf dem Mac, im Browser und in der Pipeline. Was drin ist → +43 664 1964199Kontakt →

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.

Tab Scripts eines GET-Requests Health mit drei Feldern: PRE-REQUEST setzt die Variable requestedAt, POST-RESPONSE ist leer, TESTS prüft, dass der Status 200 ist
Ein Request mit Pre-request-Skript und einem Test. Gesendet wird wie immer mit Mod+Enter.
  1. 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.
  2. Post-response läuft nach der Antwort, etwa um ein Token aus dem Body für die nächsten Requests zu merken.
  3. 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.

GruppeOperatoren
Vergleicheq, neq, gt, gte, lt, lte, between
Listen und Textin, notIn, contains, notContains, length, matches, notMatches, startsWith, endsWith
Ohne WertisEmpty, 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. 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, process oder fetch.
  • bru.setEnvVar(…, { persist: true }) und Postmans Umgebungs-Schreibzugriffe ändern keine Dateien.
  • setTimeout und bru.sleep laufen auf rt.sleep und 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.

Runner-Fenster Run folder: users mit 3 Iterationen, Delay 0, Stop at the first failure, Environment Local und Data file; sechs grüne Zeilen Create user und List users mit Status 200, darunter die Tests des gewählten Schritts
Ein Lauf über den Ordner users mit drei Iterationen: alle sechs Requests grün, unten der gewählte Schritt mit seinen Tests.
  1. 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.
  2. Bei Bedarf Iterations, Delay (ms) und Stop at the first failure setzen. Die Umgebung ist die oben gewählte.
  3. 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.
  4. 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.

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
OptionBedeutung
--data FILECSV oder JSON; jede Zeile eine Iteration
--iterations NDie Requests N-mal ausführen
--delay MSPause zwischen Requests
--bailBeim ersten Fehlschlag aufhören
--reporter NAME[=FILE]text, json oder junit, mehrfach möglich
--no-scriptsOhne Skripte; Assertions laufen weiter
--no-promptEin 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

Fundstellen auf dieser Seite

Die hochgestellten Ziffern im Text verweisen hierher. Antippen zeigt die Fundstelle direkt an der Textstelle, alle Fundstellen der Website stehen gesammelt auf einer Seite.

  1. 1

    Skript-Sandbox: QuickJS in WebAssembly ↑Produkt · Repo des Kerns von RequestTailor, crates/rt-script (api.d.ts, README) · geprüft am 22.11.2026

  2. 2

    Shims für bru.*, pm.* und insomnia ↑Produkt · Repo des Kerns von RequestTailor, crates/rt-script/SHIM-COVERAGE.md · geprüft am 22.11.2026

  3. 3

    Runner, rt run, JUnit und JSON, Exit-Code 4 ↑Produkt · Repo des Kerns von RequestTailor, crates/rt-core (runner, assert), crates/rt-cli/README.md (Exit codes) · geprüft am 22.11.2026

Häufige Fragen

Kurz beantwortet.

Kann ich Tests schreiben, ohne JavaScript zu können?
Ja. Der Tab Assertions prüft Status, Header, Antwortzeit und Werte im Body mit Operatoren wie eq, contains oder isJson. Assertions laufen auch in Collections, deren Skripten du nicht vertraust, und in rt run mit --no-scripts.
Laufen Postman-Tests mit pm.test und pm.expect?
Ja, über Shims auf der Skript-API von RequestTailor. Was nicht unterstützt ist, scheitert mit einer klaren Meldung, und der Import-Verlustbericht nennt es vorher. Die Abdeckung je API steht in SHIM-COVERAGE.md im Repo des Kerns.
Können Skripte Dateien lesen oder ins Netz?
Nein. Skripte haben keinen Dateizugriff und kein Netz außer rt.sendRequest, das über denselben Transport wie der Request sendet. Sie schreiben auch keine Variablen in Dateien.
Was zeigt JUnit in der CI an?
Je Request eine Testsuite, je Test und je Assertion einen Testfall. Ein Request, der gar keine Antwort bekam, erscheint als Fehler; ein Request ohne Tests als bestandener Testfall, damit jeder Request in der Liste steht.

Deine Frage ist nicht dabei? Sprich mich an: +43 664 1964199 office@clouddna.at Schreib mir

Kontakt

Requests im Repo statt im Konto? Sprich mit uns.

Free ist kostenlos und bleibt es. Für eine Vorabversion, für Enterprise, für das OData-Plugin an eurem SAP-System oder für einen Wunsch an Pro und Team: Schreib mir. Ich antworte innerhalb eines Werktags, persönlich.

Martin KochGeschäftsführer, CloudDNAIch lese jede Anfrage selbst und antworte persönlich.