Willekeurige fouten simuleren voor uw eigen toepassing

In deze zelfstudie leert u hoe u Dev Proxy gebruikt om willekeurige fouten voor uw eigen toepassing te simuleren.

Voorwaarden

In dit deel van de zelfstudie wordt ervan uitgegaan dat u Dev Proxy op uw computer hebt geïnstalleerd en geconfigureerd. Zo niet, doe dat nu.

Als u deze zelfstudie wilt volgen, hebt u een toepassing nodig die API's aanroept. U moet ook de URL's van de API's kennen die door uw toepassing worden aangeroepen.

U kunt Dev Proxy gebruiken met elk type toepassings- en technologiestack. Hier volgen instructies voor het instellen van Dev Proxy met een paar populaire technologieën.

JavaScript

Dev Proxy gebruiken met:

• Node.js toepassingen
• Node.js toepassingen in Docker-
• JavaScript Azure Functions
• SpFx-oplossingen (SharePoint Framework)

.NET

Dev Proxy gebruiken met:

• .NET-toepassingen
• .NET-toepassingen in Docker
• .NET Aspire-toepassingen

Als u Dev Proxy gebruikt met een .NET 4.8-app, moet u Dev Proxy registreren op uw systeem met behulp van netsh.

Overige

Als u Dev Proxy wilt gebruiken met een toepassing aan de clientzijde, hoeft u doorgaans geen extra stappen uit te voeren. Nadat u Dev Proxy hebt gestart, worden alle aanvragen van uw computer automatisch onderschept.

Als u Dev Proxy wilt gebruiken met een toepassing aan de serverzijde die is gebouwd met een technologie die hier niet wordt vermeld, moet u mogelijk extra stappen uitvoeren om uw toepassing te configureren voor het gebruik van Dev Proxy. Raadpleeg de documentatie voor uw technologie om te leren hoe u deze configureert voor het gebruik van een netwerkproxy. Als u vragen hebt, kunt u hulp vragen in de Dev Proxy-community op Discord.

Dev Proxy starten met het bewaken van uw URL's

Start Dev Proxy en bewaak de URL's van de API's die door uw toepassing worden aangeroepen. Als uw toepassing bijvoorbeeld een API aanroept die zich in https://api.contoso.com/v1/customersbevindt, start u Dev Proxy en controleert u het URL-patroon https://api.contoso.com/*.

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

De parameter --urls-to-watch vertelt Dev Proxy welke verzoeken moeten worden onderschept. Het jokerteken * aan het einde van de URL vertelt Dev Proxy alle aanvragen te onderscheppen naar URL's die beginnen met https://api.contoso.com/.

Begin met het gebruik van uw toepassing zoals u dat normaal zou doen. Dev Proxy onderschept alle aanvragen naar de URL's die u hebt opgegeven. In de opdrachtprompt ziet u berichten over de aanvragen die Dev Proxy onderschept.

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

Belangrijk

Als u geen berichten in de opdrachtprompt ziet, controleert u of u de toepassing juist hebt geconfigureerd voor het gebruik van Dev Proxy. Controleer ook of Dev Proxy aanvragen onderschept voor API-URL's die door uw toepassing worden gebruikt. Als u vragen hebt, kunt u hulp vragen in de Dev Proxy-community op Discord.

Uw eigen configuratiebestanden maken

Dev Proxy maakt standaard gebruik van het devproxyrc.json-bestand in de map Dev Proxy-installatie voor de configuratie-instellingen. Het bestand is geconfigureerd om willekeurige fouten voor de JSON Placeholder-API te simuleren. Als u realistischere resultaten wilt krijgen, maakt u uw eigen configuratiebestanden met fouten die relevanter zijn voor uw toepassing en de API's die worden gebruikt, en gebruikt u deze met Dev Proxy.

Laten we eens kijken of u een configuratiebestand wilt opslaan in de projectmap voor uw app, zodat u de configuratie-instellingen kunt delen met de rest van uw team.

1. Kopieer devproxyrc.json en devproxy-errors.jsonin de installatiemap van de Dev Proxy.
2. Plak de bestanden in de projectmap.

Wanneer u een configuratiebestand gebruikt dat buiten het installatiebestand van de Dev Proxy is opgeslagen, moet u ervoor zorgen dat de pluginPath verwijzingen juist zijn. In plaats van de paden naar de map Dev Proxy-installatie in uw configuratiebestand hard te coderen, kunt u de ~appFolder aan het begin van het pad gebruiken om een dynamische verwijzing naar de map Dev Proxy-installatie op te nemen.

1. Open het devproxyrc.json-bestand in een teksteditor.
2. Zoek de GenericRandomErrorPlugin-invoegtoepassing in de plugins matrix.
3. Werk de pluginPath bij naar ~appFolder/plugins/dev-proxy-plugins.dll.
4. Zoek de RetryAfterPlugin plugin in de plugins array.
5. Werk de pluginPath bij naar ~appFolder/plugins/dev-proxy-plugins.dll.
6. Wijzig in een opdrachtprompt de werkmap naar je projectmap.
7. Voer devproxy --config-file devproxyrc.json in en druk op Enter- om dev proxy te starten met behulp van uw configuratiebestand.
8. Verzend een verzoek naar de JSON Placeholder API vanaf de opdrachtregel en bekijk de uitvoer.
9. Druk op Ctrl + C- om dev proxy veilig te stoppen.

Tip

Installeer de Dev Proxy Toolkit-extensie voor Visual Studio Code, zodat u eenvoudig configuratiebestanden kunt maken en bijwerken.

Volgende stap

Dev Proxy ondersteunt veel verschillende scenario's waarmee u robuustere toepassingen kunt bouwen. Bekijk de handleidingen voor instructies voor meer informatie over het gebruik van de verschillende Dev Proxy-functies en het verbeteren van uw toepassing.

Handleidingen verkennen