Simular erros aleatórios para a sua própria aplicação

Neste tutorial, vai aprender a utilizar o Dev Proxy para simular erros aleatórios para a sua própria aplicação.

Pré-requisitos

Esta parte do tutorial pressupõe que instalou e configurou o Proxy de Dev no seu computador. Caso contrário, faça-o agora.

Para seguir este tutorial, precisa de uma aplicação que chame APIs. Também precisa de saber os URLs das APIs que a sua aplicação chama.

Pode utilizar o Dev Proxy com qualquer tipo de pilha de aplicação e tecnologia. Seguem-se instruções sobre como configurar o Dev Proxy com algumas tecnologias populares.

JavaScript

Utilize o Proxy de Programador com:

• Node.js aplicações
• Node.js aplicações no Docker
• Funções do Azure JavaScript
• soluções SharePoint Framework (SPFx)

.NET

Utilize o Proxy de Programador com:

• Aplicações .NET
• Aplicações .NET no Docker
• Aplicações .NET Aspire

Se estiver a utilizar o Proxy de Dev com uma aplicação .NET 4.8, terá de registar o Proxy de Dev no seu sistema com netsh.

Outro

Se quiser utilizar o Proxy de Dev com uma aplicação do lado do cliente, normalmente não precisa de efetuar passos adicionais. Depois de iniciar o Dev Proxy, este interceta automaticamente todos os pedidos do seu computador.

Se quiser utilizar o Dev Proxy com uma aplicação do lado do servidor criada com uma tecnologia não listada aqui, poderá ter de tomar medidas adicionais para configurar a sua aplicação para utilizar o Proxy de Dev. Verifique a documentação da sua tecnologia para saber como configurá-la para utilizar um proxy de rede. Se tiver dúvidas, peça ajuda na comunidade de Proxy dev no Discord.

Iniciar o Proxy de Programador com a monitorização dos URLs

Inicie o Proxy de Programador e monitorize os URLs das APIs que a sua aplicação chama. Por exemplo, se a aplicação chamar uma API localizada em https://api.contoso.com/v1/customers, inicie o Proxy de Dev e monitorize o padrão https://api.contoso.com/*de URL .

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

O --urls-to-watch parâmetro indica ao Dev Proxy, que pede para intercetar. O caráter universal * no final do URL indica ao Dev Proxy para intercetar todos os pedidos aos URLs que começam com https://api.contoso.com/.

Comece a utilizar a sua aplicação como faria normalmente. O Dev Proxy interceta todos os pedidos para os URLs que especificou. Na linha de comandos, verá mensagens sobre os pedidos que o Dev Proxy interceta.

```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 não vir mensagens na linha de comandos, certifique-se de que configurou corretamente a sua aplicação para utilizar o Proxy de Dev. Além disso, verifique se o Proxy de Dev está a intercetar pedidos para URLs de API que a sua aplicação utiliza. Se tiver dúvidas, peça ajuda na comunidade de Proxy dev no Discord.

Criar os seus próprios ficheiros de configuração

Por predefinição, o Proxy de Dev utiliza o devproxyrc.json ficheiro na pasta de instalação do Proxy dev para as respetivas definições de configuração. O ficheiro está configurado para simular erros aleatórios para a API de Marcador de Posição JSON. Para obter resultados mais realistas, crie os seus próprios ficheiros de configuração com erros mais relevantes para a sua aplicação e as APIs que utiliza e utilize-os com o Proxy de Dev.

Vamos considerar que pretende armazenar um ficheiro de configuração na pasta do projeto para a sua aplicação, para que possa partilhar as definições de configuração com o resto da sua equipa.

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

Ao utilizar um ficheiro de configuração armazenado fora do ficheiro de instalação do Proxy dev, tem de garantir que as pluginPath referências estão corretas. Em vez de codificar os caminhos para a pasta de instalação do Dev Proxy no ficheiro de configuração, pode utilizar o ~appFolder no início do caminho para incluir uma referência dinâmica de volta à pasta de instalação do Dev Proxy.

1. Num editor de texto, abra o devproxyrc.json ficheiro.
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. Numa linha de comandos, altere o diretório de trabalho para a pasta do projeto.
7. Introduza devproxy --config-file devproxyrc.json e prima Enter para iniciar o Dev Proxy com o ficheiro de configuração.
8. Envie um pedido para a API de Marcador de Posição JSON a partir da linha de comandos e veja o resultado.
9. Prima Ctrl + C para parar o Dev Proxy em segurança.

Dica

Instale a extensão Dev Proxy Toolkit para o Visual Studio Code, o que facilita a criação e atualização de ficheiros de configuração.

Passo seguinte

O Proxy de Programador suporta vários cenários diferentes que o ajudam a criar aplicações mais robustas. Explore os guias de procedimentos para saber como utilizar as diferentes funcionalidades do Dev Proxy e melhorar a sua aplicação.

Explorar guias de procedimentos