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.

Vereisten

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 weten van de API's 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 aantal populaire technologieën.

JavaScript

Dev Proxy gebruiken met:

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

.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 automatisch alle aanvragen van uw computer 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 voor meer informatie over het configureren ervan voor het gebruik van een netwerkproxy. Als u vragen hebt, kunt u om 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 uw toepassing aanroept. Als uw toepassing bijvoorbeeld een API aanroept die zich bevindt op https://api.contoso.com/v1/customers, start u Dev Proxy en controleert u het URL-patroon https://api.contoso.com/*.

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

De --urls-to-watch parameter vertelt Dev Proxy, die vraagt om te onderscheppen. Het jokerteken * aan het einde van de URL vertelt Dev Proxy dat alle aanvragen naar URL's moeten worden onderschept 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 uw toepassing juist hebt geconfigureerd voor het gebruik van Dev Proxy. Controleer ook of Dev Proxy aanvragen onderschept naar API-URL's die uw toepassing gebruikt. Als u vragen hebt, kunt u om hulp vragen in de Dev Proxy-community op Discord.

Uw eigen configuratiebestanden maken

Standaard gebruikt Dev Proxy het devproxyrc.json bestand in de installatiemap Dev Proxy voor de configuratie-instellingen. Het bestand is geconfigureerd voor het simuleren van willekeurige fouten voor de tijdelijke aanduidingen-API voor JSON. 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.

Stel dat 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 Dev Proxy.
2. Plak de bestanden in de projectmap.

Wanneer u een configuratiebestand gebruikt dat is opgeslagen buiten het installatiebestand van de Dev Proxy, moet u ervoor zorgen dat de pluginPath verwijzingen juist zijn. In plaats van de paden naar de installatiemap dev-proxy in uw configuratiebestand hard te coderen, kunt u de ~appFolder aan het begin van het pad gebruiken om een dynamische verwijzing terug naar de installatiemap dev-proxy 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 invoegtoepassing in de plugins matrix.
5. Werk de pluginPath bij naar ~appFolder/plugins/dev-proxy-plugins.dll.
6. Wijzig in een opdrachtprompt de werkmap in de projectmap.
7. Voer in devproxy --config-file devproxyrc.json en druk op Enter om Dev Proxy te starten met behulp van uw configuratiebestand.
8. Verzend een aanvraag naar de tijdelijke aanduiding-API van JSON 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, waarmee u eenvoudig configuratiebestanden kunt maken en bijwerken.

Volgende stap

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

Handleidingen verkennen