Simular erros aleatórios para seu próprio aplicativo

Neste tutorial, você aprenderá a usar o Proxy de Desenvolvimento para simular erros aleatórios para seu próprio aplicativo.

Pré-requisitos

Esta parte do tutorial pressupõe que você instalou e configurou o Proxy de Desenvolvimento em seu computador. Se não, faça isso agora.

Para seguir este tutorial, você precisa de um aplicativo que chame APIs. Você também precisa saber as URLs das APIs que seu aplicativo chama.

Você pode usar o Proxy de Desenvolvimento com qualquer tipo de pilha de aplicativos e tecnologias. Aqui estão instruções sobre como configurar o Proxy de Desenvolvimento com algumas tecnologias populares.

JavaScript

Use o Proxy de Desenvolvimento com:

• aplicativosNode.js
• Node.js aplicativos no Docker
• JavaScript Azure Functions
• soluções de Estrutura do SharePoint (SPFx)

.NET

Use o Proxy de Desenvolvimento com:

• Aplicativos .NET
• Aplicativos .NET no Docker
• Aplicativos .NET Aspire

Se você estiver usando o Proxy de Desenvolvimento com um aplicativo .NET 4.8, será necessário registrar o Proxy de Desenvolvimento em seu sistema usando netsh.

Outros

Se você quiser usar o Proxy de Desenvolvimento com um aplicativo do lado do cliente, normalmente você não precisa executar nenhuma etapa adicional. Depois de iniciar o Proxy de Desenvolvimento, ele intercepta automaticamente todas as solicitações do computador.

Se você quiser usar o Proxy de Desenvolvimento com um aplicativo do lado do servidor criado com uma tecnologia não listada aqui, talvez seja necessário executar etapas extras para configurar seu aplicativo para usar o Proxy de Desenvolvimento. Verifique a documentação de sua tecnologia para saber como configurá-la para usar um proxy de rede. Se você tiver alguma dúvida, peça ajuda na comunidade proxy de desenvolvimento no Discord.

Iniciar o Proxy de Desenvolvimento com o monitoramento das URLs

Inicie o Proxy de Desenvolvimento e monitore as URLs das APIs que seu aplicativo chama. Por exemplo, se o aplicativo chamar uma API localizada em https://api.contoso.com/v1/customers, inicie o Proxy de Desenvolvimento e monitore o padrão https://api.contoso.com/*de URL .

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

O --urls-to-watch parâmetro informa ao Proxy de Desenvolvimento, quais solicitações interceptar. O curinga * no final da URL informa ao Proxy de Desenvolvimento para interceptar todas as solicitações para URLs que começam com https://api.contoso.com/.

Comece a usar seu aplicativo como normalmente faria. O Proxy de Desenvolvimento intercepta todas as solicitações para as URLs especificadas. No prompt de comando, você vê mensagens sobre as solicitações interceptadas pelo Proxy de Desenvolvimento.

```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 você não vir nenhuma mensagem no prompt de comando, verifique se configurou corretamente seu aplicativo para usar o Proxy de Desenvolvimento. Além disso, marcar se o Proxy de Desenvolvimento estiver interceptando solicitações para URLs de API que seu aplicativo usa. Se você tiver alguma dúvida, peça ajuda na comunidade proxy de desenvolvimento no Discord.

Criar seus próprios arquivos de configuração

Por padrão, o Proxy de Desenvolvimento usa o devproxyrc.json arquivo na pasta de instalação do Proxy de Desenvolvimento para suas configurações. O arquivo é configurado para simular erros aleatórios para a API de Espaço Reservado JSON. Para obter resultados mais realistas, crie seus próprios arquivos de configuração com erros mais relevantes para seu aplicativo e as APIs que ele usa e use-os com o Proxy de Desenvolvimento.

Vamos considerar que você deseja armazenar um arquivo de configuração na pasta do projeto para seu aplicativo, para que você possa compartilhar as configurações com o restante da equipe.

1. Na pasta de instalação do Proxy de Desenvolvimento, copie devproxyrc.json e devproxy-errors.json.
2. Na pasta do projeto, cole os arquivos.

Ao usar um arquivo de configuração armazenado fora do arquivo de instalação do Proxy de Desenvolvimento, você precisa garantir que as pluginPath referências estejam corretas. Em vez de codificar os caminhos para a pasta de instalação do Proxy de Desenvolvimento no arquivo de configuração, você pode usar o ~appFolder no início do caminho para incluir uma referência dinâmica de volta à pasta de instalação do Proxy de Desenvolvimento.

1. Em um editor de texto, abra o arquivo devproxyrc.json.
2. Localize o GenericRandomErrorPlugin plug-in na plugins matriz.
3. Atualize o pluginPath para ~appFolder/plugins/dev-proxy-plugins.dll.
4. Localize o RetryAfterPlugin plug-in na plugins matriz.
5. Atualize o pluginPath para ~appFolder/plugins/dev-proxy-plugins.dll.
6. Em um prompt de comando, altere o diretório de trabalho para a pasta do projeto.
7. Insira devproxy --config-file devproxyrc.json e pressione Enter para iniciar o Proxy de Desenvolvimento usando o arquivo de configuração.
8. Envie uma solicitação para a API de Espaço Reservado JSON da linha de comando e exiba a saída.
9. Pressione Ctrl + C para interromper com segurança o Proxy de Desenvolvimento.

Dica

Instale a extensão do Kit de Ferramentas de Proxy de Desenvolvimento para Visual Studio Code o que facilita a criação e atualização de arquivos de configuração.

Próxima etapa

O Proxy de Desenvolvimento dá suporte a muitos cenários diferentes que ajudam você a criar aplicativos mais robustos. Explore os guias de instruções para saber como usar os diferentes recursos de Proxy de Desenvolvimento e melhorar seu aplicativo.

Explorar guias de instruções