Sobre o projeto

modern-errors-winston é um plugin Winston para a biblioteca modern-errors que melhora a forma como os erros JavaScript são registrados em aplicações Node.js. Ele fornece dois helpers principais de formato Winston: BaseError.fullFormat() e BaseError.shortFormat(). O formato completo é destinado a logging estruturado e inclui todas as propriedades do erro, como nome, mensagem, stack, propriedades personalizadas, erros de causa aninhados e entradas AggregateError. Ele é projetado para ser combinado com formatos como format.json() ou format.prettyPrint(), e é especialmente útil com transports como HTTP. A saída é descrita como segura para JSON, o que a torna adequada para logs legíveis por máquina e ingestão de logs remotos. O formato curto é destinado a saída de console legível por humanos. Ele registra apenas o nome do erro, a mensagem e, opcionalmente, o trace de pilha. Ele é projetado para ser combinado com formatos como format.simple() ou format.cli(), e é útil com transports de console. O plugin pode ser configurado em vários níveis, incluindo por classe de erro, por subclasse, por instância de erro e por chamada de formato. As opções de configuração incluem se incluir o trace de pilha e uma substituição opcional para o nível de log Winston. Ele também funciona com exceções não capturadas quando usado com o tratamento de exceções do Winston. Comparado com o formato de erro padrão do Winston, este plugin registra o nome do erro, suporta erros aninhados, incluindo causa e erros agregados, produz uma saída completa segura para JSON, permite traces de pilha opcionais no formato curto e não modifica a instância do erro. O pacote é um módulo ES, requer Node.js 18.18.0 ou mais recente, e requer que o Winston seja instalado separadamente.