Simulare errori casuali per la propria applicazione

In questa esercitazione si apprenderà come usare Dev Proxy per simulare errori casuali per la propria applicazione.

Prerequisiti

Questa parte dell'esercitazione presuppone l'installazione e la configurazione di Dev Proxy nel computer. In caso contrario, eseguire questa operazione ora.

Per seguire questa esercitazione, è necessaria un'applicazione che chiama le API. È anche necessario conoscere gli URL delle API chiamate dall'applicazione.

È possibile usare Dev Proxy con qualsiasi tipo di stack di applicazioni e tecnologie. Ecco le istruzioni per configurare Dev Proxy con alcune tecnologie più diffuse.

Usare Dev Proxy con:

• Node.js applicazioni
• applicazioni Node.js in Docker
• Funzioni JavaScript di Azure
• soluzioni SharePoint Framework (SPFx)

Usare Dev Proxy con:

• applicazioni .NET
• applicazioni .NET in Docker
• applicazioni .NET Aspire

Se si usa Dev Proxy con un'app .NET 4.8, è necessario registrare Dev Proxy nel sistema usando netsh.

Altro

Se si vuole usare Dev Proxy con un'applicazione lato client, in genere non è necessario eseguire altri passaggi. Dopo aver avviato Dev Proxy, intercetta automaticamente tutte le richieste dal computer.

Se si vuole usare Dev Proxy con un'applicazione lato server compilata con una tecnologia non elencata qui, potrebbe essere necessario eseguire passaggi aggiuntivi per configurare l'applicazione per l'uso di Dev Proxy. Consultare la documentazione relativa alla tecnologia per informazioni su come configurarla per l'uso di un proxy di rete. In caso di domande, chiedere assistenza nella community di Dev Proxy su Discord.

Avviare Dev Proxy con il monitoraggio degli URL

Avviare Dev Proxy e monitorare gli URL delle API chiamate dall'applicazione. Ad esempio, se l'applicazione chiama un'API che si trova in https://api.contoso.com/v1/customers, avviare Dev Proxy e monitorare il modello di URL https://api.contoso.com/*.

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

Il parametro --urls-to-watch indica a Dev Proxy le richieste da intercettare. Il carattere jolly * alla fine dell'URL indica a Dev Proxy di intercettare tutte le richieste agli URL che iniziano con https://api.contoso.com/.

Iniziare a usare l'applicazione come normalmente. Dev Proxy intercetta tutte le richieste agli URL specificati. Nel prompt dei comandi vengono visualizzati messaggi sulle richieste intercettate da 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

Se non vengono visualizzati messaggi nel prompt dei comandi, assicurarsi di aver configurato correttamente l'applicazione per l'uso di Dev Proxy. Controllare anche se Dev Proxy intercetta le richieste agli URL API usati dall'applicazione. In caso di domande, chiedere assistenza nella community di Dev Proxy su Discord.

Creare file di configurazione personalizzati

Per impostazione predefinita, Dev Proxy usa il file devproxyrc.json nella cartella di installazione di Dev Proxy per le impostazioni di configurazione. Il file è configurato per simulare errori casuali per l'API segnaposto JSON. Per ottenere risultati più realistici, creare file di configurazione personalizzati con errori più rilevanti per l'applicazione e le API usate e usarli con Dev Proxy.

Si consideri che si vuole archiviare un file di configurazione nella cartella del progetto per l'app, in modo da poter condividere le impostazioni di configurazione con il resto del team.

1. Nella cartella di installazione di Dev Proxy copiare devproxyrc.json e devproxy-errors.json.
2. Nella cartella del progetto incollare i file.

Quando si usa un file di configurazione archiviato all'esterno del file di installazione di Dev Proxy, è necessario assicurarsi che i riferimenti pluginPath siano corretti. Anziché fissare in modo rigido i percorsi della cartella di installazione del Dev Proxy nel file di configurazione, è possibile utilizzare ~appFolder all'inizio del percorso per includere un riferimento dinamico alla cartella di installazione del Dev Proxy.

1. In un editor di testo aprire il file devproxyrc.json.
2. Individuare il plug-in GenericRandomErrorPlugin nella matrice di plugins.
3. Aggiornare il pluginPath in ~appFolder/plugins/dev-proxy-plugins.dll.
4. Individuare il plug-in RetryAfterPlugin nella matrice di plugins.
5. Aggiornare il pluginPath in ~appFolder/plugins/dev-proxy-plugins.dll.
6. In un prompt dei comandi, cambiare la directory di lavoro alla cartella del progetto.
7. Immettere devproxy --config-file devproxyrc.json e premere INVIO per avviare Dev Proxy usando il file di configurazione.
8. Inviare una richiesta all'API segnaposto JSON dalla riga di comando e visualizzare l'output.
9. Premere CTRL + C per arrestare in modo sicuro il Proxy di sviluppo.

Suggerimento

Installare l'estensione Dev Proxy Toolkit per Visual Studio Code che semplifica la creazione e l'aggiornamento dei file di configurazione.

Passaggio successivo

Dev Proxy supporta molti scenari diversi che consentono di creare applicazioni più affidabili. Esplorare le guide pratiche per informazioni su come usare le diverse funzionalità del proxy di sviluppo e migliorare l'applicazione.

Esplora guide pratiche