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 che nel computer sia stato installato e configurato Dev Proxy. In caso contrario, farlo 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. Di seguito sono riportate le istruzioni per configurare Dev Proxy con alcune tecnologie comuni.

JavaScript

Usare Dev Proxy con:

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

.NET

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.

Altri

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 https://api.contoso.com/*URL .

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

Il --urls-to-watch parametro 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 di consueto. 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 devproxyrc.json file 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 ora di voler 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 pluginPath riferimenti siano corretti. Invece di impostare come hardcoded i percorsi della cartella di installazione di Dev Proxy nel file di configurazione, è possibile usare all'inizio ~appFolder del percorso per includere un riferimento dinamico alla cartella di installazione di Dev Proxy.

1. Aprire il file devproxyrc.json in un editor di testo.
2. Individuare il GenericRandomErrorPlugin plug-in nella plugins matrice.
3. Aggiornare in pluginPath~appFolder/plugins/dev-proxy-plugins.dll.
4. Individuare il RetryAfterPlugin plug-in nella plugins matrice.
5. Aggiornare in pluginPath~appFolder/plugins/dev-proxy-plugins.dll.
6. In un prompt dei comandi modificare la directory di lavoro nella 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, semplificando 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à di Dev Proxy e migliorare l'applicazione.

Esplorare le guide pratiche