Partager via

Simuler des erreurs aléatoires pour votre propre application

Dans ce tutoriel, vous allez apprendre à utiliser le proxy de développement pour simuler des erreurs aléatoires pour votre propre application.

Conditions préalables

Cette partie du didacticiel suppose que vous avez installé et configuré le proxy de développement sur votre ordinateur. Si ce n’est pas encore fait, prenez le temps de le faire maintenant.

Pour suivre ce tutoriel, vous avez besoin d’une application qui appelle des API. Vous devez également connaître les URL des API que votre application appelle.

Vous pouvez utiliser Dev Proxy avec n’importe quel type d’application et de pile technologique. Voici des instructions sur la configuration du proxy de développement avec quelques technologies populaires.

Utilisez le proxy de développement avec :

Démarrer le proxy de développement avec la surveillance de vos URL

Démarrez le proxy de développement et surveillez les URL des API que votre application appelle. Par exemple, si votre application appelle une API située à https://api.contoso.com/v1/customers, démarrez le proxy de développement et surveillez le modèle https://api.contoso.com/*d’URL.

devproxy --urls-to-watch "https://api.contoso.com/*"

Le paramètre --urls-to-watch indique au proxy de développement quelles requêtes intercepter. Le caractère générique * à la fin de l’URL indique au proxy de développement d’intercepter toutes les requêtes aux URL qui commencent par https://api.contoso.com/.

Commencez à utiliser votre application comme vous le feriez normalement. Le proxy de développement intercepte toutes les requêtes adressées aux URL que vous avez spécifiées. Dans l'invite de commandes, vous voyez des messages concernant les requêtes interceptées par Dev Proxy.

```text
 request     GET https://api.contoso.com/v1/customers
     api   ╭ Passed through
           ╰ GET https://api.contoso.com/v1/customers
 request     GET https://api.contoso.com/v1/customers
   chaos   ╭ 403 Forbidden
           ╰ GET https://api.contoso.com/v1/customers

Importante

Si vous ne voyez aucun message dans l’invite de commandes, vérifiez que vous avez correctement configuré votre application pour utiliser le proxy de développement. Vérifiez également si le proxy de développement intercepte les demandes adressées aux URL d’API que votre application utilise. Si vous avez des questions, demandez de l’aide dans la communauté du proxy de développement sur Discord.

Créer vos propres fichiers de configuration

Par défaut, le proxy dev utilise le devproxyrc.json fichier dans le dossier d’installation du proxy de développement pour ses paramètres de configuration. Le fichier est configuré pour simuler des erreurs aléatoires pour l’API d’espace réservé JSON. Pour obtenir des résultats plus réalistes, créez vos propres fichiers de configuration avec des erreurs plus pertinentes pour votre application et les API qu’il utilise, puis utilisez-les avec le proxy de développement.

Considérons que vous souhaitez stocker un fichier de configuration dans le dossier projet de votre application, afin de pouvoir partager les paramètres de configuration avec le reste de votre équipe.

  1. Dans le dossier d’installation du proxy de développement, copiez devproxyrc.json et devproxy-errors.json.
  2. Dans votre dossier de projet, collez les fichiers.

Lorsque vous utilisez un fichier de configuration stocké en dehors du fichier d’installation du proxy de développement, vous devez vous assurer que les pluginPath références sont correctes. Au lieu de coder en dur les chemins vers le dossier d’installation du proxy de développement dans votre fichier de configuration, vous pouvez utiliser le ~appFolder début du chemin pour inclure une référence dynamique au dossier d’installation du proxy de développement.

  1. Dans un éditeur de texte, ouvrez le devproxyrc.json fichier.
  2. Recherchez le GenericRandomErrorPlugin plug-in dans le plugins tableau.
  3. Mettez à jour le pluginPath à ~appFolder/plugins/DevProxy.Plugins.dll.
  4. Recherchez le RetryAfterPlugin plug-in dans le plugins tableau.
  5. Mettez à jour le pluginPath vers ~appFolder/plugins/DevProxy.Plugins.dll.
  6. Dans une invite de commandes, remplacez le répertoire de travail par votre dossier de projet.
  7. Entrez devproxy --config-file devproxyrc.json et appuyez sur Entrée pour démarrer le proxy de développement à l’aide de votre fichier de configuration.
  8. Envoyez une requête à l’API d’espace réservé JSON à partir de la ligne de commande et affichez la sortie.
  9. Appuyez sur Ctrl + C pour arrêter le proxy de développement en toute sécurité.

Conseil / Astuce

Installez l’extension Dev Proxy Toolkit pour Visual Studio Code, ce qui facilite la création et la mise à jour des fichiers de configuration.

Étape suivante

Le proxy de développement prend en charge de nombreux scénarios différents qui vous aident à créer des applications plus robustes. Explorez les guides pratiques pour découvrir comment utiliser les différentes fonctionnalités du proxy de développement et améliorer votre application.

Explorer les guides pratiques

  • Last updated on