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.

Prérequis

Cette partie du didacticiel suppose que vous avez installé et configuré le proxy de développement sur votre ordinateur. Si ce n’est pas le cas, faites-le 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 de pile d’applications et de technologies. Voici des instructions pour configurer le proxy de développement avec quelques technologies populaires.

JavaScript

Utilisez le proxy de développement avec :

• Node.js applications
• Node.js applications dans Docker
• Azure Functions JavaScript
• solutions SharePoint Framework (SPFx)

.NET

Utilisez le proxy de développement avec :

• Applications .NET
• Applications .NET dans Docker
• Applications .NET Aspire

Si vous utilisez dev Proxy avec une application .NET 4.8, vous devez inscrire le proxy de développement sur votre système à l’aide netshde .

Autres

Si vous souhaitez utiliser le proxy de développement avec une application côté client, vous n’avez généralement pas besoin d’effectuer des étapes supplémentaires. Une fois que vous avez démarré Dev Proxy, il intercepte automatiquement toutes les demandes de votre ordinateur.

Si vous souhaitez utiliser dev Proxy avec une application côté serveur créée avec une technologie non répertoriée ici, vous devrez peut-être prendre des mesures supplémentaires pour configurer votre application afin qu’elle utilise le proxy de développement. Consultez la documentation de votre technologie pour savoir comment la configurer pour utiliser un proxy réseau. Si vous avez des questions, demandez de l’aide dans la communauté de proxy de développement sur Discord.

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

Démarrez dev Proxy et surveillez les URL des API que votre application appelle. Par exemple, si votre application appelle une API située dans 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 --urls-to-watch paramètre indique au proxy de développement les demandes d’interception. Le caractère générique * à la fin de l’URL indique au proxy de développement d’intercepter toutes les demandes aux URL qui commencent par https://api.contoso.com/.

Commencez à utiliser votre application comme vous le feriez normalement. Dev Proxy 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 demandes interceptées par le proxy de développement.

```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

Important

Si vous ne voyez aucun message dans l’invite de commandes, assurez-vous que vous avez correctement configuré votre application pour utiliser le proxy de développement. En outre, case activée si le proxy de développement intercepte les requêtes adressées aux URL d’API que votre application utilise. Si vous avez des questions, demandez de l’aide dans la communauté de proxy de développement sur Discord.

Créer vos propres fichiers de configuration

Par défaut, dev Proxy 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’elle utilise, puis utilisez-les avec le proxy de développement.

Considérons que vous souhaitez stocker un fichier de configuration dans le dossier de 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 d’accès au dossier d’installation du proxy de développement dans votre fichier de configuration, vous pouvez utiliser au ~appFolder début du chemin d’accès pour inclure une référence dynamique au dossier d’installation du proxy de développement.

1. Ouvrez le fichier devproxyrc.json dans un éditeur de texte.
2. Recherchez le GenericRandomErrorPlugin plug-in dans le plugins tableau.
3. Mettez à jour vers pluginPath~appFolder/plugins/dev-proxy-plugins.dll.
4. Recherchez le RetryAfterPlugin plug-in dans le plugins tableau.
5. Mettez à jour vers pluginPath~appFolder/plugins/dev-proxy-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

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

Dev Proxy 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