cURL, HAR, Postman oder OpenAPI in einen k6-Test importieren

Eine vorhandene Anfrage in einen k6-Test importieren

Sie müssen kein k6-Skript von Hand schreiben, um zu starten. Wenn Sie eine Anfrage bereits als cURL-Befehl, HAR-Datei, Postman-Collection oder OpenAPI-Spezifikation vorliegen haben, kann LoadFocus sie in ein lauffähiges k6-Skript umwandeln und in einem Schritt an Ihren Test anhängen.

Die Konvertierung läuft vollständig in Ihrem Browser. Während der Konvertierung wird nichts an unsere Server gesendet, und das erzeugte Skript wird genauso an den Test angehängt, als hätten Sie es selbst hochgeladen.

Wo Sie es finden

Öffnen Sie die Seite Neuer k6-Test (Sie müssen angemeldet sein) und klappen Sie den Bereich Import from cURL, HAR, Postman or OpenAPI direkt über dem Bereich zum Hochladen von Skripten auf.

Unterstützte Formate

• cURL: Fügen Sie einen curl-Befehl ein, zum Beispiel einen, der aus dem Netzwerk-Tab Ihres Browsers kopiert wurde ("Copy as cURL").
• HAR: Ein HTTP-Archiv, exportiert aus den Entwicklertools Ihres Browsers. Statische Assets (Bilder, CSS, Schriften) werden standardmäßig herausgefiltert, damit sich der Test auf echte API-Aufrufe konzentriert.
• Postman: Eine als JSON exportierte Postman-Collection. Collection-Variablen werden nach Möglichkeit aufgelöst.
• OpenAPI: Eine OpenAPI- oder Swagger-Spezifikation. Anfrage-Bodys werden aus dem Schema erzeugt, wenn kein Beispiel vorhanden ist.

Schritt für Schritt

1. Wählen Sie das Format in der Formatauswahl.
2. Geben Sie die Quelle an. Fügen Sie den cURL-Befehl oder Dateiinhalt in das Textfeld ein oder klicken Sie auf Choose file, um eine HAR-, Postman- oder OpenAPI-Datei hochzuladen. Beim Hochladen einer Datei wird das Format automatisch anhand des Dateinamens erkannt.
3. Entscheiden Sie, wie mit erkannten Auth-Werten umgegangen wird. Das Kontrollkästchen Include detected auth values in the script ist standardmäßig aktiviert.
   • Aktiviert (empfohlen für Cloud-Läufe): Erkannte Authorization-, Cookie- und API-Key-Header werden unverändert in das Skript geschrieben, sodass der Test beim ersten Lauf funktioniert.
   • Deaktiviert: Diese Werte werden zu __ENV-Platzhaltern, die Sie selbst ausfüllen. Cloud-Läufe setzen diese Platzhalterwerte nicht, sodass der Test bei der Authentifizierung fehlschlägt, bis Sie sie angeben.
4. Klicken Sie auf Import. LoadFocus erzeugt ein k6-Skript, hängt es als .js-Datei an den Test an und trägt einen Testnamen basierend auf dem Host der Anfrage ein, falls Sie noch keinen gesetzt haben. Beim Hochladen einer Datei wird der Import automatisch ausgeführt.
5. Prüfen Sie das erzeugte Skript. Klappen Sie Preview generated script auf, um den k6-Code zu sehen, mit Schaltflächen zum Kopieren oder Herunterladen.
6. Konfigurieren Sie die Last und speichern Sie. Legen Sie wie gewohnt virtuelle Nutzer, Dauer, Ramp-up und Lastverteilung fest und führen Sie den Test aus oder speichern Sie ihn. Die vollständige Konfiguration finden Sie unter So führen Sie einen neuen k6-Lasttest durch.

Hinweise

• Ein erneuter Import ersetzt das zuvor importierte Skript. Manuell hochgeladene Dateien bleiben unberührt.
• Der erzeugte options-Block (virtuelle Nutzer, Dauer) ist eine Vorgabe für lokale Läufe. In der Cloud haben die Werte Vorrang, die Sie im Bereich Load Configuration festlegen.
• Möchten Sie außerhalb der App arbeiten? Dieselbe Konvertierung gibt es als kostenlose öffentliche Tools: cURL to k6, HAR to k6, Postman to k6 und OpenAPI to k6.