Repolode
Enviar
fullstack-build

fullstack-build/tslog

Logger universal para TypeScript e JavaScript, com saída de terminal formatada, JSON estruturado com campos primeiro, mascaramento de segredos e nenhuma dependência em tempo de execução.

Ver no GitHubSite
Estrelas
1,750
Forks
74
Issues abertas
2
Último commit
há 15 horas

O que é?

tslog é uma biblioteca de logging para TypeScript e JavaScript que funciona em Node.js, navegadores, Deno, Bun, workers e React Native com uma única API. Por padrão, exibe uma saída colorida e legível em terminais interativos e texto simples quando a saída é redirecionada ou executada em CI. Também é possível habilitar um formato JSON plano, com os campos primeiro, para pipelines de logs em produção.

A biblioteca atende a necessidades comuns, como níveis de log com suporte a níveis personalizados, loggers filhos que herdam configurações e campos vinculados, além do mascaramento por chave, caminho e correspondências de regex para impedir que segredos apareçam nos logs. Erros e stack traces são formatados e serializáveis, e os source maps mapeiam posições de volta aos arquivos TypeScript originais no Node, Bun e Deno.

Para direcionar a saída, tslog oferece transports para arquivos, endpoints HTTP, buffers circulares em memória e worker threads, além de presets que geram saída compatível com pino ou no formato OpenTelemetry OTLP/JSON. O pacote principal não tem dependências em tempo de execução, e há um subpath slim para bundles de navegador sensíveis ao tamanho.

Recursos principais

  • 01Mesma API em Node.js, navegadores, Deno, Bun, workers e React Native
  • 02Saída formatada e colorida em terminais, texto simples quando redirecionada e opção de JSON
  • 03Mascaramento de segredos por nome de chave, caminho JSON, regex ou placeholder com hash
  • 04Loggers filhos que herdam configurações e campos vinculados
  • 05Transports configuráveis para arquivos, HTTP, buffers circulares e worker threads
  • 06Nenhuma dependência em tempo de execução e tipos TypeScript

Casos de uso

  • Adicionar logging consistente a um serviço Node.js, com saída JSON em produção
  • Fazer logging em um módulo compartilhado executado tanto no navegador quanto no servidor
  • Mascarar senhas e tokens antes que os logs saiam do processo
  • Enviar logs para um arquivo, um coletor HTTP ou um endpoint OpenTelemetry

Início rápido

  1. 1

    Instale o tslog pelo npm

    npm install tslog
  2. 2

    Importe Logger e registre uma mensagem

Antes de usar

  • Requer Node.js 22 ou mais recente e é exclusivo de ESM, sem suporte a require() do CommonJS.
  • A versão 5 traz uma reformulação incompatível, então a atualização da v4 exige alterações no código.

Tópicos

#logging#typescript#javascript#logger#structured-logging#json#observability#error-handling#exceptions#json-api

Perguntas frequentes

O que é tslog?
Logger universal para TypeScript e JavaScript, com saída de terminal formatada, JSON estruturado com campos primeiro, mascaramento de segredos e nenhuma dependência em tempo de execução. tslog é uma biblioteca de logging para TypeScript e JavaScript que funciona em Node.js, navegadores, Deno, Bun, workers e React Native com uma única API. Por padrão, exibe uma saída colorida e legível em terminais interativos e texto simples quando a saída é redirecionada ou executada em CI. Também é possível habilitar um formato JSON plano, com os campos primeiro, para pipelines de logs em produção.
tslog é gratuito? Qual é a licença?
tslog é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
tslog ainda é mantido?
Manutenção ativa. O último commit de tslog foi em 20 de out. de 2026.
Para que posso usar tslog?
Adicionar logging consistente a um serviço Node.js, com saída JSON em produção Fazer logging em um módulo compartilhado executado tanto no navegador quanto no servidor Mascarar senhas e tokens antes que os logs saiam do processo Enviar logs para um arquivo, um coletor HTTP ou um endpoint OpenTelemetry
Como instalar tslog?
Instale o tslog pelo npm: npm install tslog Importe Logger e registre uma mensagem
Onde consigo tslog?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/fullstack-build/tslog

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados