You are viewing the Spanish (Mexico) site, but your language preference is set to English. Switch to English site →

Menu

Gestión y depuración de errores

Flex UI (la interfaz de usuario de Flex) proporciona la clase FlexError, el evento FlexError y la interfaz de usuario del informe de errores para facilitar la detección y notificación de problemas. Sigue leyendo para obtener más información sobre estas herramientas y cómo afectan a tu proceso de desarrollo.

La clase FlexError

La clase FlexError es una extensión de la clase normal JavaScript Error, con contexto agregado. Esta clase incluye más información sobre errores para ayudar a detectar problemas y consolidar la API de Flex UI (la interfaz de usuario de Flex). Los campos más destacados de FlexError son:

Field Name (Nombre del campo) Descripción
error.message Mensaje de error con una cadena única que no cambia y que describe el error
error.content.description Una versión más larga de error.message. Puede incluir una explicación más larga del error y también información de variables, como el SID de trabajo o el SID de tarea en cuestión.
error.content.wrappedError Cualquier error capturado de bibliotecas de terceros, los SDK de Twilio o un plugin personalizado. El error original se coloca en este campo.

Verás FlexErrors en dos contextos principales:

FlexError en una invocación de acción

Si una acción de Flex llamada por tus fallas de plugin, lanza un FlexError en su rechazo de promesa. Dependiendo del error, FlexError puede envolver otro error, como un error lanzado por la actividad en segundo plano.

try {
    await Flex.Actions.invokeAction("SomeAction", payload)
} catch(e){
    // e is FlexError
}

Detectar el evento flexError

Cada vez que Flex UI (la interfaz de usuario de Flex) crea un error en su código, tanto si lo arroja como si no, el evento de flexError informa su creación. Puedes suscribirte a ese evento para tus propios fines de elaboración de informes. El evento es estrictamente informativo. Las acciones del usuario en el gestor de eventos no tendrán ninguna influencia en cómo Flex UI (la interfaz de usuario de Flex) trata el error en sí.

manager.events.addListener("flexError", (error) => {
    // do your own handling/reporting
});

Obtener informes y registros de errores

Se permite que los registros o errores del lado del cliente contengan PII (información personal identificable) porque son transitorios y no se guardan más allá de una sesión de usuario. Sin embargo, al exportarlos, la PII también se exporta y se guarda en el archivo. Toma las precauciones adecuadas para proteger los datos de tus clientes al guardar y compartir este archivo.

Los informes de error y los registros mencionados en la documentación del usuario final de la interfaz de usuario de error también se pueden recuperar mediante programación. Flex.Monitor.getLogs devuelve los registros actuales y Flex.Monitor.getError todos los errores registrados en una matriz. Puedes utilizar estos métodos para implementar informes especiales o gestión de informes.

import { Monitor } from "@twilio/flex-ui";

Monitor.getErrors(); // returns { errors: [Monitor.FlexErrorJSON] }
Monitor.getLogs(); // returns { logs: 'string' }

Modo degradado de Flex UI y administrador de clientes

A partir de Flex UI v 1.31, Flex UI (la interfaz de usuario de Flex) podrá inicializarse y funcionar en modo degradado. Puedes encontrar la lista de componentes en los que se basa Flex UI (la interfaz de usuario de Flex) y que se pueden iniciar en modo degradado en nuestra referencia de API.

Flex UI ahora también expone las API de ClientManager que se pueden utilizar para simular uno o más SDK que se ejecutan en un estado degradado.

Estas API se pueden utilizar para probar el comportamiento de Flex UI y los plugins de Flex con el fin de asegurarse de que cualquier lógica personalizada se utilice para situaciones de cliente degradado específicas.

Para probar degradaciones de clientes específicas, se puede utilizar el método forceDegraded para degradar los clientes necesarios. Dado que el administrador de clientes degrada un cliente durante su inicialización, el método forceDegraded solo se puede utilizar antes del inicio de la inicialización del administrador de Flex.

Para restablecer la fuerza de los clientes degradados, los usuarios pueden volver a cargar la página después de quitar la llamada al método forceDegraded. Si deseas obtener una descripción más detallada de las nuevas API, consulta nuestra referencia de la API de Flex UI (la interfaz de usuario de Flex) para ClientManager.

Próximos pasos

Calificar esta página:

¿Necesitas ayuda?

Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.

Gracias por tus comentarios.

Selecciona los motivos de tus comentarios. La información adicional que nos brindas nos ayuda a mejorar nuestra documentación:

Enviando tus comentarios…
🎉 Gracias por tus comentarios.
Se produjo un error. Inténtalo de nuevo.

Gracias por tus comentarios.

thanks-feedback-gif