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é) puis, à l'étape 1 Votre script de test, cliquez sur Importer depuis cURL, HAR, Postman ou OpenAPI sous la zone de téléversement (à côté de Pas encore de script ?) pour ouvrir le panneau d'import.

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 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 (5 Mo au maximum), ou choisissez un fichier HAR, Postman ou OpenAPI sous ou téléversez un fichier :. Choisir un fichier lance l'import aussitôt. Le format est deviné d'après le nom du fichier (.har, un nom contenant postman ou openapi/swagger, collection.json, .yaml ou .yml) ; si le nom de votre fichier ne correspond pas, définissez d'abord le Format.
3. Décidez comment traiter les valeurs d'authentification détectées. La case Inclure les valeurs d'authentification détectées dans le 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 Importer. 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 Voir le script généré 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.
• Si vous collez un script k6 terminé au lieu d'une commande cURL, le panneau propose Utiliser ceci comme mon script k6, qui l'attache tel quel sans le convertir.
• 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 à l'étape 2 Quelle charge ? 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.