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

Menu

Tratamento e depuração de erros

O Flex UI (IU do Flex) fornece a classe FlexError, o evento FlexError e a IU do Relatório de erros para facilitar a notificação e a geração de relatórios de problemas. Continue lendo para saber mais sobre essas ferramentas e como elas afetam seu processo de desenvolvimento.

A classe FlexError

A classe FlexError é uma extensão da classe de Erro JavaScript normal, com contexto adicionado. Essa classe inclui mais informações sobre erros para ajudar a identificar problemas e consolidar a API Flex UI (IU do Flex). Os campos mais notáveis do FlexError são:

Nome do campo Descrição
error.message Mensagem de erro com string não mutável exclusiva que descreve o erro
error.content.description Uma versão mais longa de error.message. Pode incluir uma explicação mais longa do erro e também incluir informações variáveis, como o SID do funcionário ou o SID da tarefa em questão.
error.content.wrappedError Qualquer erro capturado de bibliotecas de terceiros, SDKs da Twilio ou um plugin personalizado. O erro original é colocado nesse campo.

Você verá FlexErrors em dois contextos principais:

FlexError em um invocação de ação

Se uma Flex Action (Ação do Flex) chamada pelo seu plugin falhar, ela lançará um FlexError na rejeição de promessa. Dependendo do erro, o FlexError pode quebrar outro erro, como um erro lançado pelo back‐end.

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

Ouvir evento flexError

Sempre que o Flex UI (IU do Flex) cria um erro em seu código, independentemente de lançá‐lo ou não, sua criação é relatada pelo evento flexError. Você pode se inscrever nesse evento para fins de relatório. O evento é estritamente informativo. As ações do usuário no manipulador de eventos não terão qualquer influência sobre como o Flex UI (IU do Flex) lida com o erro em si.

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

Obter relatórios e logs de erro

Logs ou erros do lado do cliente podem conter PII (informação pessoalmente identificável) porque são temporários e não são salvos além de uma sessão do usuário. Ao exportá‐los, no entanto, as PII também são exportadas e salvas no arquivo. Tome as devidas precauções para proteger os dados de seus clientes ao salvar e compartilhar esse arquivo.

Relatórios e logs de erros mencionados nos Error UI End User Docs (Documentos do usuário final de IU de erro) também podem ser recuperados de forma programática. Flex.Monitor.getLogs retorna os registros atuais e Flex.Monitor.getError retorna todos os erros registrados em uma matriz. Você pode usar esses métodos para implementar relatórios especiais ou gerenciamento de relatórios.

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

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

Modo degradado do Flex UI (IU do Flex) e Gerenciador de clientes

A partir do Flex UI (IU do Flex) v 1.31, o Flex UI (IU do Flex) poderá inicializar e funcionar em Degraded mode (Modo degradado). Você pode encontrar a lista de componentes dos quais o Flex UI (IU do Flex) depende e pode iniciar no modo degradado em nossa API reference (Referência à API).

O Flex UI (IU do Flex) também expõe as APIs ClientManager que podem ser usadas para simular um ou mais sdks em execução em um estado degradado.

Essas APIs podem ser usadas para testar o comportamento do Flex UI (IU do Flex) e dos plugins do Flex para garantir que qualquer lógica personalizada seja tratada para cenários específicos do Client (Cliente) degradado.

Para testar degradações específicas do Client (Cliente), forceDegraded o método pode ser usado para degradar o(s) Cliente(s) necessário(s). Como o Gerenciador de clientes degrada um cliente durante sua inicialização, forceDegraded o método só pode ser usado antes do início da inicialização do Flex Manager.

Para redefinir os clientes com degradação forçada, os usuários podem recarregar a página depois de remover a chamada do método forceDegraded. Para obter uma descrição mais detalhada das novas APIs, consulte nossa Flex UI API Reference for ClientManager (Referência à API Flex UI (IU do Flex) para ClientManager).

Próximas etapas

Classifique esta página:

Precisa de ajuda?

Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.

Obrigado pelo seu feedback!

Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

Enviando seu feedback...
🎉 Obrigado pelo seu feedback!
Algo deu errado. Tente novamente.

Obrigado pelo seu feedback!

thanks-feedback-gif