Importer cURL, HAR, Postman ou OpenAPI dans un test k6

Importer une requete existante dans un test k6

Vous n'avez pas besoin d'ecrire un script k6 a la main pour demarrer. Si vous avez deja une requete capturee sous forme de commande cURL, de fichier HAR, de collection Postman ou de specification OpenAPI, LoadFocus peut la convertir en un script k6 pret a lancer et l'attacher a votre test en une seule etape.

La conversion s'execute entierement dans votre navigateur. Rien n'est envoye a nos serveurs pendant la conversion, et le script genere est attache au test exactement comme si vous l'aviez televerse vous-meme.

Panneau d'import sur la page Nouveau test k6

Ou le trouver

Ouvrez la page Nouveau test k6 (vous devez etre connecte) et depliez le panneau Import from cURL, HAR, Postman or OpenAPI, juste au-dessus de la section de televersement de scripts.

Formats pris en charge

  • cURL: collez une commande curl, par exemple une copiee depuis l'onglet reseau de votre navigateur ("Copy as cURL").
  • HAR: un fichier HTTP Archive exporte depuis les outils de developpement de votre navigateur. Les ressources statiques (images, CSS, polices) sont filtrees par defaut afin que le test se concentre sur les vrais appels d'API.
  • Postman: une collection Postman exportee au format JSON. Les variables de collection sont resolues lorsque c'est possible.
  • OpenAPI: une specification OpenAPI ou Swagger. Les corps de requete sont generes a partir du schema lorsqu'aucun exemple n'est fourni.

Etape par etape

  1. Choisissez le format dans le selecteur de format.
  2. Fournissez la source. Collez la commande cURL ou le contenu du fichier dans la zone de texte, ou cliquez sur Choose file pour televerser un fichier HAR, Postman ou OpenAPI. Lors du televersement d'un fichier, le format est detecte automatiquement d'apres son nom.
  3. Decidez comment traiter les valeurs d'authentification detectees. La case Include detected auth values in the script est cochee par defaut.
    • Cochee (recommande pour les executions cloud): les en-tetes Authorization, Cookie et de cle d'API detectes sont ecrits tels quels dans le script, afin que le test fonctionne des la premiere execution.
    • Decochee: ces valeurs deviennent des espaces reserves __ENV que vous remplissez vous-meme. Les executions cloud ne definissent pas ces valeurs, le test echouerait donc a l'authentification jusqu'a ce que vous les fournissiez.
  4. Cliquez sur Import. LoadFocus genere un script k6, l'attache au test sous forme de fichier .js et renseigne un nom de test base sur l'hote de la requete si vous n'en avez pas defini. Lors du televersement d'un fichier, l'import s'execute automatiquement.
  5. Verifiez le script genere. Depliez Preview generated script pour voir le code k6, avec des boutons pour le Copier ou le Telecharger.
  6. Configurez la charge et enregistrez. Definissez vos utilisateurs virtuels, la duree, le ramp-up et la distribution de charge comme d'habitude, puis lancez ou enregistrez le test. Consultez Comment lancer un nouveau test de charge k6 pour le parcours de configuration complet.

Remarques

  • Un nouvel import remplace le script importe precedemment. Les fichiers que vous avez televerses manuellement ne sont pas touches.
  • Le bloc options genere (utilisateurs virtuels, duree) est une valeur par defaut pour les executions locales. Dans le cloud, les valeurs que vous definissez dans la section Load Configuration ont la priorite.
  • Vous preferez travailler en dehors de l'application? La meme conversion est disponible sous forme d'outils publics gratuits: cURL to k6, HAR to k6, Postman to k6 et OpenAPI to k6.