Simulación de errores aleatorios para su propia aplicación

En este tutorial, aprenderá a usar el proxy de desarrollo para simular errores aleatorios para su propia aplicación.

Requisitos previos

En esta parte del tutorial se supone que instaló y configuró el proxy de desarrollo en el equipo. Si no es así, haz eso ahora.

Para seguir este tutorial, necesita una aplicación que llame a las API. También debe conocer las direcciones URL de las API a las que llama la aplicación.

Puede usar dev Proxy con cualquier tipo de aplicación y pila tecnológica. Estas son las instrucciones para configurar el proxy de desarrollo con algunas tecnologías populares.

JavaScript

Uso del proxy de desarrollo con:

• aplicaciones deNode.js
• Node.js aplicaciones en Docker
• Azure Functions de JavaScript
• soluciones de SharePoint Framework (SPFx)

.NET

Uso del proxy de desarrollo con:

• Aplicaciones .NET
• Aplicaciones .NET en Docker
• Aplicaciones de .NET Aspire

Si usa el proxy de desarrollo con una aplicación de .NET 4.8, debe registrar el proxy de desarrollo en el sistema mediante netsh.

Otros

Si quiere usar dev Proxy con una aplicación del lado cliente, normalmente no es necesario realizar ningún paso adicional. Después de iniciar el proxy de desarrollo, intercepta automáticamente todas las solicitudes de la máquina.

Si quiere usar el proxy de desarrollo con una aplicación del lado servidor creada con una tecnología que no aparece aquí, es posible que deba realizar pasos adicionales para configurar la aplicación para usar el proxy de desarrollo. Consulte la documentación de la tecnología para aprender a configurarla para usar un proxy de red. Si tiene alguna pregunta, pida ayuda en la comunidad de Dev Proxy en Discord.

Iniciar proxy de desarrollo con la supervisión de las direcciones URL

Inicie el proxy de desarrollo y supervise las direcciones URL de las API a las que llama la aplicación. Por ejemplo, si la aplicación llama a una API ubicada en https://api.contoso.com/v1/customers, inicie el proxy de desarrollo y supervise el patrón https://api.contoso.com/*de dirección URL .

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

El --urls-to-watch parámetro indica al Proxy de desarrollo, qué solicitudes se interceptan. El carácter * comodín al final de la dirección URL indica al Proxy de desarrollo que intercepte todas las solicitudes a las direcciones URL que comienzan por https://api.contoso.com/.

Empiece a usar la aplicación como lo haría normalmente. El proxy de desarrollo intercepta todas las solicitudes a las direcciones URL que especificó. En el símbolo del sistema, verá mensajes sobre las solicitudes que intercepta el proxy de desarrollo.

```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

Si no ve ningún mensaje en el símbolo del sistema, asegúrese de que ha configurado correctamente la aplicación para usar el proxy de desarrollo. Además, compruebe si el proxy de desarrollo intercepta las solicitudes a las direcciones URL de API que usa la aplicación. Si tiene alguna pregunta, pida ayuda en la comunidad de Dev Proxy en Discord.

Crear sus propios archivos de configuración

De forma predeterminada, Dev Proxy usa el devproxyrc.json archivo en la carpeta de instalación del proxy de desarrollo para sus opciones de configuración. El archivo está configurado para simular errores aleatorios para la API de marcador de posición JSON. Para obtener resultados más realistas, cree sus propios archivos de configuración con errores más relevantes para la aplicación y las API que usa y úselas con proxy de desarrollo.

Consideremos que desea almacenar un archivo de configuración en la carpeta del proyecto de la aplicación, por lo que puede compartir las opciones de configuración con el resto del equipo.

1. En la carpeta de instalación del proxy de desarrollo, copie devproxyrc.json y devproxy-errors.json.
2. En la carpeta del proyecto, pegue los archivos.

Al usar un archivo de configuración que se almacena fuera del archivo de instalación del proxy de desarrollo, debe asegurarse de que las pluginPath referencias son correctas. En lugar de codificar de forma rígida las rutas de acceso a la carpeta de instalación del proxy de desarrollo en el archivo de configuración, puede usar al ~appFolder principio de la ruta de acceso para incluir una referencia dinámica a la carpeta de instalación del proxy de desarrollo.

1. En un editor de texto, abra el archivo devproxyrc.json.
2. Busque el GenericRandomErrorPlugin complemento en la plugins matriz.
3. Actualice a pluginPath~appFolder/plugins/dev-proxy-plugins.dll.
4. Busque el RetryAfterPlugin complemento en la plugins matriz.
5. Actualice a pluginPath~appFolder/plugins/dev-proxy-plugins.dll.
6. En un símbolo del sistema, cambie el directorio de trabajo a la carpeta del proyecto.
7. Escriba devproxy --config-file devproxyrc.json y presione Entrar para iniciar proxy de desarrollo mediante el archivo de configuración.
8. Envíe una solicitud a la API de marcador de posición JSON desde la línea de comandos y vea la salida.
9. Presione Ctrl + C para detener de forma segura el proxy de desarrollo.

Sugerencia

Instale la extensión Dev Proxy Toolkit para Visual Studio Code, lo que facilita la creación y actualización de archivos de configuración.

Paso siguiente

Dev Proxy admite muchos escenarios diferentes que le ayudan a crear aplicaciones más sólidas. Explore las guías paso a paso para aprender a usar las diferentes características del proxy de desarrollo y mejorar la aplicación.

Exploración de guías paso a paso