Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 aplicativo e tecnologia. Aqui estão instruções sobre como configurar o Proxy de Desenvolvimento com algumas tecnologias populares.
Use o Dev Proxy com:
Inicie o Proxy de Desenvolvimento monitorando suas URLs
Inicie o Proxy de Desenvolvimento e monitore as URLs das APIs que seu aplicativo chama. Por exemplo, se o seu aplicativo chamar uma API localizada em https://api.contoso.com/v1/customers
, inicie o Proxy de Desenvolvimento e monitore o padrão de URL https://api.contoso.com/*
.
devproxy --urls-to-watch "https://api.contoso.com/*"
O parâmetro --urls-to-watch
indica ao Proxy de Desenvolvimento quais solicitações devem ser interceptadas. O curinga *
no final da URL indica ao Dev Proxy para interceptar todas as solicitações para URLs que começam com https://api.contoso.com/
.
Comece a usar seu aplicativo como faria normalmente. O Proxy de Desenvolvimento intercepta todas as solicitações para as URLs especificadas. No prompt de comando, você verá mensagens sobre as solicitações que o Dev Proxy intercepta.
```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, verifique se o Proxy de Desenvolvimento está interceptando solicitações para URLs de API que seu aplicativo usa. Se você tiver alguma dúvida, peça ajuda na comunidade de Proxy de Desenvolvimento no Discord.
Criar seus próprios arquivos de configuração
Por padrão, o Proxy de Desenvolvimento usa o arquivo devproxyrc.json
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 sua equipe.
- Na pasta de instalação do Proxy de Desenvolvimento, copie
devproxyrc.json
edevproxy-errors.json
. - 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.
- Em um editor de texto, abra o
devproxyrc.json
arquivo. - Localize o plug-in
GenericRandomErrorPlugin
na matrizplugins
. - Atualize o
pluginPath
para~appFolder/plugins/DevProxy.Plugins.dll
. - Localize o plug-in
RetryAfterPlugin
na matrizplugins
. - Atualize o
pluginPath
para~appFolder/plugins/DevProxy.Plugins.dll
. - Em um prompt de comando, altere o diretório de trabalho para a pasta do projeto.
- Insira
devproxy --config-file devproxyrc.json
e pressione Enter para iniciar o Proxy de Desenvolvimento usando o arquivo de configuração. - Envie uma solicitação para a API de Espaço Reservado JSON da linha de comando e exiba a saída.
- 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 a atualização de arquivos de configuração.
Próxima etapa
O Proxy de Desenvolvimento dá suporte a vários cenários diferentes que ajudam você a criar aplicativos mais robustos. Explore os guias de instruções para saber como usar os diferentes recursos do Proxy de Desenvolvimento e melhorar seu aplicativo.