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 klicken Sie in Schritt 1 Ihr Testskript unter dem Upload-Bereich (neben Noch kein Skript?) auf Aus cURL, HAR, Postman oder OpenAPI importieren, um den Import-Bereich zu öffnen.

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 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 (höchstens 5 MB) oder wählen Sie eine HAR-, Postman- oder OpenAPI-Datei unter oder Datei hochladen: aus. Mit der Dateiauswahl startet der Import sofort. Das Format wird anhand des Dateinamens erraten (.har, ein Name mit postman oder openapi/swagger, collection.json, .yaml oder .yml); passt Ihr Dateiname nicht, legen Sie zuerst das Format fest.
3. Entscheiden Sie, wie mit erkannten Auth-Werten umgegangen wird. Das Kontrollkästchen Erkannte Auth-Werte in das Skript übernehmen 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 Importieren. 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 Generiertes Skript ansehen 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.
• Wenn Sie ein fertiges k6-Skript statt eines cURL-Befehls einfügen, bietet das Panel Als mein k6-Skript verwenden an. Damit wird es unverändert angehängt, ohne es umzuwandeln.
• Der erzeugte options-Block (virtuelle Nutzer, Dauer) ist eine Vorgabe für lokale Läufe. In der Cloud haben die Werte Vorrang, die Sie in Schritt 2 Wie viel Last? 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.