Simulera slumpmässiga fel för ditt eget program

I den här självstudien får du lära dig hur du använder Dev Proxy för att simulera slumpmässiga fel för ditt eget program.

Förutsättningar

Den här delen av självstudien förutsätter att du har installerat och konfigurerat Dev Proxy på datorn. Gör annars det nu.

Om du vill följa den här handledningen behöver du ett program som anropar API:er. Du behöver också känna till URL:erna för de API:er som programmet anropar.

Du kan använda Dev Proxy med alla typer av program och teknikstackar. Här följer instruktioner för hur du konfigurerar Dev Proxy med några populära tekniker.

JavaScript

Använd Dev Proxy med:

• Node.js applikationer
• Node.js applikationer i Docker
• JavaScript Azure-funktioner
• SharePoint Framework-lösningar (SPFx)

.NET

Använd Dev Proxy med:

• .NET-program
• .NET-applikationer i Docker-miljö
• .NET Aspire-applikationer

Om du använder Dev Proxy med en .NET 4.8-app måste du registrera Dev Proxy på ditt system med hjälp av netsh.

Andra

Om du vill använda Dev Proxy med ett program på klientsidan behöver du vanligtvis inte vidta några extra åtgärder. När du har startat Dev Proxy fångas alla begäranden från datorn upp automatiskt.

Om du vill använda Dev Proxy med ett program på serversidan som skapats med en teknik som inte visas här, kan du behöva vidta extra åtgärder för att konfigurera programmet att använda Dev Proxy. Läs dokumentationen för din teknik för att lära dig hur du konfigurerar den för att använda en nätverksproxy. Om du har några frågor kan du be om hjälp i communityn Dev Proxy på Discord.

Starta Dev Proxy med övervakning av dina URL:er

Starta Dev Proxy och övervaka URL:erna för de API:er som programmet anropar. Om ditt program till exempel anropar ett API som finns på https://api.contoso.com/v1/customersstartar du Dev Proxy och övervakar URL-mönstret https://api.contoso.com/*.

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

Parametern --urls-to-watch anvisar Dev Proxy vilka förfrågningar som ska fångas upp. Jokertecknet * i slutet av URL:en uppmanar Dev Proxy att fånga upp alla begäranden till URL:er som börjar med https://api.contoso.com/.

Börja använda ditt program som vanligt. Dev Proxy fångar upp alla begäranden till de URL:er som du har angett. I kommandotolken visas meddelanden om de begäranden som Dev Proxy fångar upp.

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

Viktig

Om du inte ser några meddelanden i kommandotolken kontrollerar du att du har konfigurerat programmet korrekt så att det använder Dev Proxy. Kontrollera också om Dev Proxy fångar upp begäranden till API-URL:er som ditt program använder. Om du har några frågor kan du be om hjälp i communityn Dev Proxy på Discord.

Skapa egna konfigurationsfiler

Som standard använder Dev Proxy den devproxyrc.json filen i installationsmappen för Dev Proxy för konfigurationsinställningarna. Filen är konfigurerad för att simulera slumpmässiga fel för JSON-platshållar-API:et. För att få mer realistiska resultat skapar du egna konfigurationsfiler med fel som är mer relevanta för ditt program och de API:er som används och använder dem med Dev Proxy.

Anta att du vill lagra en konfigurationsfil i projektmappen för din app, så att du kan dela konfigurationsinställningarna med resten av teamet.

1. I installationsmappen för Dev Proxy kopierar du devproxyrc.json och devproxy-errors.json.
2. Klistra in filerna i projektmappen.

När du använder en konfigurationsfil som lagras utanför installationsfilen för Dev Proxy måste du se till att pluginPath referenser är korrekta. I stället för att hårdkoda sökvägarna till installationsmappen för Dev Proxy i konfigurationsfilen kan du använda ~appFolder i början av sökvägen för att inkludera en dynamisk referens tillbaka till installationsmappen för Dev Proxy.

1. Öppna filen devproxyrc.json i en textredigerare.
2. Leta upp plugin-programmet GenericRandomErrorPlugin i matrisen plugins.
3. Uppdatera pluginPath till ~appFolder/plugins/dev-proxy-plugins.dll.
4. Leta upp plugin-programmet RetryAfterPlugin i matrisen plugins.
5. Uppdatera pluginPath till ~appFolder/plugins/dev-proxy-plugins.dll.
6. I kommandotolken ändrar du arbetskatalogen till din projektmapp.
7. Ange devproxy --config-file devproxyrc.json och tryck på . Tryck på för att starta Dev Proxy med din konfigurationsfil.
8. Skicka en begäran till JSON-platshållar-API:et från kommandoraden och visa utdata.
9. Tryck på Ctrl + C för att stoppa Dev Proxy på ett säkert sätt.

Tips

Installera Dev Proxy Toolkit-tillägget för Visual Studio Code, vilket gör det enkelt att skapa och uppdatera konfigurationsfiler.

Nästa steg

Dev Proxy har stöd för många olika scenarier som hjälper dig att skapa mer robusta program. Utforska instruktionsguiderna för att lära dig hur du använder de olika Dev Proxy-funktionerna och förbättrar ditt program.

Utforska instruktioner