Ausführung

Die Ausführung (der Runner) sendet Anfragen nacheinander und sagt dir, welche bestanden haben. Eine Anfrage besteht, wenn sie eine Antwort bekommt und jede Prüfung aus ihrem Tab „Tests“ und ihren Skripten erfüllt ist. Nutze sie, um nach einer Änderung eine ganze API auszuprobieren, dieselben Anfragen für viele Eingaben auszuführen oder einen Bericht zu erstellen.

Durchlauf startenCopy Anchor Link

Es gibt mehrere Wege hinein:

• Klicke in der Seitenleiste einen Ordner mit der rechten Maustaste an und wähle Ordner ausführen, oder eine Anfrage und wähle Anfrage ausführen. Der Durchlauf startet sofort und die Seite „Ausführung“ öffnet sich.
• Wähle in der Seitenleiste mehrere Ordner oder Anfragen aus, klicke sie mit der rechten Maustaste an und wähle N Objekte ausführen.
• Wähle Arbeitsbereich ausführen in der Befehlspalette.
• Öffne die Seite „Ausführung“, richte den Durchlauf ein und wähle Ausführen. Die Ausführung steht in der Seitenleiste unter Tests, oder wähle Ansicht › Ausführung (⌥⌘R).

Auf der Seite „Ausführung“ enthält die Karte Ausführen die Einstellungen:

Wähle Ausführen (⌘R) zum Starten und Stoppen (⌘.), um einen Durchlauf vorzeitig zu beenden. Ist eine geschützte Umgebung aktiv, heißt der Knopf In Production ausführen … (mit dem Namen dieser Umgebung), und der Durchlauf fragt nach, bevor er etwas sendet. Siehe Geschützte Umgebungen.

Was in welcher Reihenfolge läuftCopy Anchor Link

Anfragen laufen in ihrer Reihenfolge in der Seitenleiste: die Anfragen eines Ordners von oben nach unten, Ordner darin an ihrer Stelle. Jede Anfrage wird genau so gesendet, als hättest du sie selbst gesendet: mit denselben Variablen, derselben Auth, denselben Skripten und Prüfungen. Spätere Anfragen können die Antworten früherer im selben Durchlauf nutzen, über Antwortwerte und Variablen, die Skripte oder Erfassungen setzen. So sendet ein Durchlauf des Alpenglow-Arbeitsbereichs zuerst Auth › Sign in, das das Token erfasst, das die Anfragen unter Orders senden.

Jede Art von Anfrage kann laufen:

• HTTP-, GraphQL- und gRPC-Anfragen sowie MCP-Aufrufe werden wie alle anderen gesendet und geprüft.
• WebSocket-, Socket.IO- und MQTT-Anfragen verbinden sich, senden ihre gesicherten Nachrichten, Ereignisse oder Veröffentlichungen, die für Durchläufe eingeschaltet sind (und MQTT abonniert seine aktivierten Filter), hören 10 Sekunden zu und schließen dann. Das Nachrichtenlog ist die Antwort, sodass Prüfungen auf dem Body damit funktionieren. Um eine andere Zeit zuzuhören, setze stream-limit (in Sekunden) unter [settings] in der Anfragedatei.
• Ein Server-Sent-Events-Stream wird 10 Sekunden gehalten und dann beendet.

Ein Pre-Request-Skript kann eine Anfrage mit pm.execution.skipRequest() überspringen; das Ergebnis sagt Von einem Pre-Request-Skript übersprungen. Ein Skript kann auch mit pm.execution.setNextRequest("Request name") springen und den Durchlauf mit pm.execution.setNextRequest(null) beenden. Ein Durchlauf, der immer wieder zurückspringt, wird nach 10.000 Sendungen in einer Iteration gestoppt.

Iterationen und DatendateienCopy Anchor Link

Iterationen führt alles so oft aus. {{$…}}-Werte wie {{$uuid}} sind jedes Mal neu, und pm.info.iteration sagt, welche Iteration es ist (ab 0).

Eine Datendatei macht den Durchlauf datengetrieben: eine Iteration pro Zeile, jede Spalte eine Variable, die die Anfragen wie jede andere nutzen, etwa {{sku}}. Skripte lesen die Zeile mit pm.iterationData.get("sku").

• CSV: eine Kopfzeile mit den Variablennamen, dann eine Zeile pro Iteration. Anführungszeichen, doppelte Anführungszeichen und Zeilenumbrüche in Anführungszeichen funktionieren.
• JSON: ein Array von Objekten, ein Objekt pro Iteration.

Zum Beispiel skus.csv für eine Anfrage an {{baseURL}}/products/{{sku}} mit einer Prüfung, dass $.sku gleich {{sku}} ist:

sku,quantity
TNT-MH-2P,1
PCK-TIT-30,2

oder dasselbe als JSON:

[
  { "sku": "TNT-MH-2P", "quantity": 1 },
  { "sku": "PCK-TIT-30", "quantity": 2 }
]

Das Feld Daten zeigt den Namen der Datei und die Zahl ihrer Zeilen. Das Kreuz daneben entfernt die Datei.

Parallele IterationenCopy Anchor Link

Bei mehr als einer Iteration lässt Gleichzeitig mehrere Iterationen nebeneinander laufen. Die Anfragen innerhalb einer Iteration bleiben in Reihenfolge, und jede Iteration behält die Variablen, die ihre eigenen Skripte setzen, sodass das Token einer Iteration nie in eine andere gelangt. Lass es bei 1 (nacheinander), wenn Iterationen voneinander abhängen oder der Server begrenzt, wie schnell du ihn aufrufen darfst.

Wiederholungen, Verzögerungen und StoppenCopy Anchor Link

• Wiederholungen sendet eine fehlschlagende Anfrage erneut, bis zu so oft. Eine Anfrage schlägt fehl, wenn sie keine Antwort bekommt oder eine Prüfung fehlschlägt. Das Ergebnis zeigt, wie viele Versuche es gebraucht hat, etwa 3 Versuche, und behält den letzten.
• Verzögern wartet zwischen Anfragen, für Server mit Ratenbegrenzung wie die Demo-API.
• Beim ersten Fehler stoppen beendet den Durchlauf, wenn eine Anfrage fehlschlägt, nach ihren Wiederholungen. Die Zusammenfassung sagt dann Bei einem Fehler gestoppt.

ErgebnisseCopy Anchor Link

Während der Durchlauf läuft, füllt sich die Liste und zeigt die Anfrage, die gerade gesendet wird. Darüber stehen die Zahlen: Anfragen, Bestanden, Fehlgeschlagen, Fehlgeschlagene Prüfungen und am Ende Dauer, mit Alle bestanden oder N fehlgeschlagen.

Jede Zeile zeigt die Art oder Methode der Anfrage, ihren Namen und ihre Adresse, den Status und die Dauer. Bei mehreren Iterationen sagt #2, zu welcher Iteration eine Zeile gehört. Unter einer fehlgeschlagenen Anfrage stehen die Prüfungen, die fehlgeschlagen sind, jeweils mit ihrer Meldung, oder der Grund, warum es keine Antwort gab. Klicke auf eine Zeile, um die Anfrage zu öffnen.

Die Seite behält den letzten Durchlauf, solange das Fenster offen ist. Jeder Austausch eines Durchlaufs steht auch im Verlauf, markiert als aus der Ausführung stammend.

BerichteCopy Anchor Link

Nach einem Durchlauf sichert Bericht sichern in der Karte Ergebnisse ihn als Datei:

Die Berichte als JUnit, JSON und HTML maskieren Secrets in den Adressen, Prüfwerten und Meldungen, Skript-Tests und Logs, die sie enthalten.

In der Befehlszeile ausführenCopy Anchor Link

echolot run führt denselben Arbeitsbereich mit denselben Einstellungen aus, für CI und das Terminal: Iterationen, Datendateien, Verzögerungen, Wiederholungen, parallele Iterationen und dieselben Berichtsformate. Siehe echolot run und Ausführen in CI.