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

Importer une requête existante dans un test k6

Vous n'avez pas besoin d'écrire un script k6 à la main pour démarrer. Si vous avez déjà une requête capturée sous forme de commande cURL, de fichier HAR, de collection Postman ou de spécification OpenAPI, LoadFocus peut la convertir en un script k6 prêt à lancer et l'attacher à votre test en une seule étape.

La conversion s'exécute entièrement dans votre navigateur. Rien n'est envoyé à nos serveurs pendant la conversion, et le script généré est attaché au test exactement comme si vous l'aviez téléversé vous-même.

Où le trouver

Ouvrez la page Nouveau test k6 (vous devez être connecté) et dépliez le panneau Import from cURL, HAR, Postman or OpenAPI, juste au-dessus de la section de téléversement de scripts.

Formats pris en charge

• cURL: collez une commande curl, par exemple une copiée depuis l'onglet réseau de votre navigateur ("Copy as cURL").
• HAR: un fichier HTTP Archive exporté depuis les outils de développement de votre navigateur. Les ressources statiques (images, CSS, polices) sont filtrées par défaut afin que le test se concentre sur les vrais appels d'API.
• Postman: une collection Postman exportée au format JSON. Les variables de collection sont résolues lorsque c'est possible.
• OpenAPI: une spécification OpenAPI ou Swagger. Les corps de requête sont générés à partir du schéma lorsqu'aucun exemple n'est fourni.

Étape par étape

1. Choisissez le format dans le sélecteur 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 téléverser un fichier HAR, Postman ou OpenAPI. Lors du téléversement d'un fichier, le format est détecté automatiquement d'après son nom.
3. Décidez comment traiter les valeurs d'authentification détectées. La case Include detected auth values in the script est cochée par défaut.
   • Cochée (recommandé pour les exécutions cloud): les en-têtes Authorization, Cookie et de clé d'API détectés sont écrits tels quels dans le script, afin que le test fonctionne dès la première exécution.
   • Décochée: ces valeurs deviennent des espaces réservés __ENV que vous remplissez vous-même. Les exécutions cloud ne définissent pas ces valeurs, le test échouerait donc à l'authentification jusqu'à ce que vous les fournissiez.
4. Cliquez sur Import. LoadFocus génère un script k6, l'attache au test sous forme de fichier .js et renseigne un nom de test basé sur l'hôte de la requête si vous n'en avez pas défini. Lors du téléversement d'un fichier, l'import s'exécute automatiquement.
5. Vérifiez le script généré. Dépliez Preview generated script pour voir le code k6, avec des boutons pour le Copier ou le Télécharger.
6. Configurez la charge et enregistrez. Définissez vos utilisateurs virtuels, la durée, 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 importé précédemment. Les fichiers que vous avez téléversés manuellement ne sont pas touchés.
• Le bloc options généré (utilisateurs virtuels, durée) est une valeur par défaut pour les exécutions locales. Dans le cloud, les valeurs que vous définissez dans la section Load Configuration ont la priorité.
• Vous préférez travailler en dehors de l'application? La même conversion est disponible sous forme d'outils publics gratuits: cURL to k6, HAR to k6, Postman to k6 et OpenAPI to k6.