echolot run

echolot run sendet die Anfragen eines Arbeitsbereichs in ihrer Reihenfolge, führt ihre Skripte und Prüfungen aus und berichtet, was bestanden hat. Es ist die Ausführung ohne das Fenster, gemacht für CI. Es führt auch eine Postman-Sammlung so aus, wie sie ist, ohne sie zu importieren.

echolot run [<options>] <source>

<source> ist ein Ordner eines Arbeitsbereichs (der mit workspace.toml darin) oder eine Datei einer Postman-Sammlung.

Einen Arbeitsbereich ausführenCopy Anchor Link

echolot run Alpenglow.echolot --folder auth/sign-in --folder catalog

catalog, auth/sign-in

✓ POST   auth/sign-in  200 150 ms
    ✓ Status equals 200
    ✓ JSON value $.access_token exists
✓ GET    catalog/list-products  200 74 ms
    ✓ Status equals 200
    ✓ JSON value $.items.length is greater than 0
    ✓ Header Content-Type contains json
    ✓ Response time (ms) is less than 1000
✓ GET    catalog/search  200 69 ms
    ✓ Status equals 200
✓ GET    catalog/get-product  200 70 ms
    ✓ Status equals 200
    ✓ JSON value $.sku equals {{productId}}
✓ GET    catalog/categories  200 73 ms
    ✓ Status equals 200
✓ GQL    catalog/search-products  200 37 ms
✓ GET    catalog/export  200 410 ms
    ✓ Status equals 200

All 7 requests passed  11/11 checks passed · 0.90 s

• Ohne --folder läuft alles. --folder nimmt einen Ordner (catalog) oder eine Anfrage (auth/sign-in), als Pfade von Slugs unter requests/, und kann mehrfach angegeben werden. Anfragen laufen in der Reihenfolge des Arbeitsbereichs.
• --env nimmt den Dateinamen der Umgebung ohne .toml (staging) oder ihren Namen (Staging).
• Die Prüfungen jeder Anfrage und ihre pm.test-Ergebnisse zählen. Eine Anfrage schlägt fehl, wenn sie keine Antwort bekommt oder eine Prüfung fehlschlägt; der Lauf endet dann mit 1.
• Antworten, die in Variablen erfasst wurden, Tokens aus OAuth-2-Client-Credentials und Werte, die Skripte setzen, gelten wie in der App für die späteren Anfragen des Laufs weiter. Werte aus Skripten gelten nur für den Lauf und werden nie in Dateien geschrieben.

Datengesteuerte LäufeCopy Anchor Link

--data führt alles einmal pro Zeile einer Datendatei aus:

• Eine CSV-Datei mit einer Kopfzeile: Jede Spalte ist für ihre Zeile eine Variable.
• Eine JSON-Datei mit einem Array von Objekten: Jeder Schlüssel ist eine Variable.

echolot run Alpenglow.echolot --folder catalog/get-product --data skus.csv

catalog/get-product · skus.csv, 2 rows

✓ #1 GET    catalog/get-product  200 133 ms
    ✓ Status equals 200
    ✓ JSON value $.sku equals {{productId}}
✓ #2 GET    catalog/get-product  200 88 ms
    ✓ Status equals 200
    ✓ JSON value $.sku equals {{productId}}

All 2 requests passed  4/4 checks passed · 0.22 s

Skripte lesen die Zeile mit pm.iterationData. Ohne Datendatei wiederholt --iterations den Lauf. --concurrency führt so viele Iterationen nebeneinander aus; was die Skripte einer Iteration setzen, bleibt ihre eigene Sache.

BerichteCopy Anchor Link

--reporter wählt einen Bericht und kann mehrfach angegeben werden. --out benennt die Datei für jeden Bericht, der nicht console ist, in der Reihenfolge der --reporter-Optionen; ein Bericht ohne Datei geht in die Standardausgabe.

echolot run Alpenglow.echolot --env staging \
  --reporter console \
  --reporter junit --out results.xml \
  --reporter html --out report.html

Ein JUnit-Bericht eines Laufs mit einer fehlgeschlagenen Prüfung:

<?xml version="1.0" encoding="UTF-8"?>
<testsuites name="Alpenglow" tests="4" failures="1" errors="0" time="0.377" timestamp="2026-11-01T09:23:04Z">
  <testsuite name="auth/sign-in" tests="2" failures="0" errors="0" skipped="0" time="0.155">
    <testcase name="Status equals 200" classname="auth.sign-in" time="0"/>
    <testcase name="JSON value $.access_token exists" classname="auth.sign-in" time="0"/>
  </testsuite>
  <testsuite name="auth/who-am-i" tests="1" failures="1" errors="0" skipped="0" time="0.083">
    <testcase name="Status equals 200" classname="auth.who-am-i" time="0">
      <failure message="expected “200”, got “401”" type="AssertionFailure"/>
    </testcase>
  </testsuite>
</testsuites>

Jeder Bericht maskiert geheime Werte, in URLs, Headern, Meldungen von Prüfungen und Protokollen, sodass du einen Bericht bedenkenlos als CI-Artefakt aufbewahren kannst.

Eine Postman-Sammlung ausführenCopy Anchor Link

echolot run shop.postman_collection.json --env-file staging.postman_environment.json --data users.csv

Die Sammlung läuft so, wie sie ist: Echolot liest sie in einen temporären Arbeitsbereich, der danach weggeworfen wird, und ihre Zugangsdaten bleiben im Speicher. Ihre Skripte vor der Anfrage und ihre Testskripte laufen wie in Newman. --env-file nimmt eine Umgebungsdatei von Postman; --env ist für Arbeitsbereiche. --folder darf einen Ordner der Sammlung ohne den obersten Ordner der Sammlung selbst nennen.

Um mit einer Sammlung weiterzuarbeiten, importiere sie stattdessen.

OptionenCopy Anchor Link

Exit-CodesCopy Anchor Link

Unter CI findest du vollständige Pipelines und unter Secrets, woher geheime Werte kommen.