Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
De un vistazo
Objetivo: Ver cómo controla la app los errores de API
Tiempo: 5 minutos
Plugins:GenericRandomErrorPlugin
Requisitos previos:Configuración del proxy de desarrollo
Al compilar aplicaciones, debe probar cómo controla la aplicación los errores de API. El proxy de desarrollo permite simular errores en cualquier API que use en la aplicación mediante GenericRandomErrorPlugin.
Simulación de errores en cualquier API
Para empezar, habilite en el GenericRandomErrorPlugin archivo de configuración.
Archivo:devproxyrc.json
{
"$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/rc.schema.json",
"plugins": [
{
"name": "GenericRandomErrorPlugin",
"enabled": true,
"pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
"configSection": "errorsContosoApi",
"urlsToWatch": [
"https://api.contoso.com/*"
]
}
]
}
Sugerencia
Dado que cada API es diferente, normalmente configura una instancia de para cada API en la GenericRandomErrorPlugin que desea simular errores. Para facilitar la administración de la configuración, asigne el configSection nombre después de la API en la que desea simular errores. Además, especifique las direcciones URL en las que desea simular errores en la urlsToWatch propiedad con el complemento. Esto facilitará la administración de la configuración y su reutilización en el futuro.
A continuación, configure el complemento para que use un archivo que contenga los errores que desea simular.
Archivo:devproxyrc.json (agregar al mismo archivo)
{
"errorsContosoApi": {
"errorsFile": "errors-contoso-api.json"
}
}
Por último, en el archivo de errores, defina la lista de respuestas de error que desea simular. Por ejemplo, para simular un error 500 con una respuesta JSON personalizada, use la siguiente configuración:
Archivo:errors-contoso-api.json
{
"$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/genericrandomerrorplugin.errorsfile.schema.json",
"errors": [
{
"request": {
"url": "https://api.contoso.com/*"
},
"responses": [
{
"statusCode": 500,
"headers": [
{
"name": "content-type",
"value": "application/json; charset=utf-8"
}
],
"body": {
"code": "InternalServerError",
"message": "Something went wrong"
}
}
]
}
]
}
Puede definir tantas respuestas de error como necesite.
Inicie Dev Proxy con el archivo de configuración y use la aplicación para ver cómo controla los errores. Para cada solicitud coincidente, dev Proxy determina si se simula un error o se pasa la solicitud a la API original mediante la tasa de errores configurada. Cuando dev Proxy simula un error, usa un error aleatorio de la matriz de respuestas de error que definió en el archivo de configuración.
Deshabilitar temporalmente los simulacros
Si usa simulacros en el archivo de configuración, puede deshabilitarlos temporalmente mediante la --no-mocks opción .
devproxy --no-mocks
Paso siguiente
Más información sobre GenericRandomErrorPlugin.
Consulte también
- Simulación de respuestas de API lentas : adición de latencia a llamadas API
- Simulación de respuestas de API de Rate-Limit : limitación de velocidad de pruebas
- Tasa de errores de solicitud de cambio : ajuste de la frecuencia con la que se producen errores
- Simulación de errores de las API de Microsoft Graph : errores específicos de Microsoft Graph
- Glosario : terminología del proxy de desarrollo