Repolode
Enviar
fullstack-build

fullstack-build/tslog

Logger universal para TypeScript y JavaScript, con salida legible en terminal, JSON estructurado con los campos al principio, enmascaramiento de secretos y cero dependencias en tiempo de ejecución.

Ver en GitHubSitio web
Estrellas
1,750
Forks
74
Issues abiertos
2
Último commit
hace 16 horas

¿Qué es?

tslog es una biblioteca de logging para TypeScript y JavaScript que funciona en Node.js, navegadores, Deno, Bun, workers y React Native con una sola API. De forma predeterminada, muestra texto legible y con colores en terminales interactivos, y texto plano cuando la salida se redirige mediante pipes o se ejecuta en CI. También se puede habilitar un formato JSON plano, con los campos al principio, para los pipelines de logs de producción.

La biblioteca cubre necesidades habituales, como niveles de log personalizables, loggers hijos que heredan la configuración y los campos vinculados, y el enmascaramiento de claves, rutas y coincidencias de expresiones regulares para evitar que los secretos aparezcan en los logs. Los errores y las trazas de pila se formatean y se pueden serializar; además, los source maps permiten asociar las posiciones con los archivos TypeScript originales en Node, Bun y Deno.

Para enrutar la salida, tslog ofrece transports para archivos, endpoints HTTP, buffers circulares en memoria y worker threads, además de presets que generan una salida compatible con pino o con el formato OpenTelemetry OTLP/JSON. El paquete principal no tiene dependencias en tiempo de ejecución y hay disponible un subpath ligero para bundles de navegador donde el tamaño es importante.

Funciones clave

  • 01La misma API en Node.js, navegadores, Deno, Bun, workers y React Native
  • 02Salida legible y con colores en terminales, y en texto plano cuando se redirige mediante pipes; JSON opcional
  • 03Enmascaramiento de secretos por nombre de clave, ruta JSON, expresión regular o marcador hash
  • 04Loggers hijos que heredan la configuración y los campos vinculados
  • 05Transports configurables para archivos, HTTP, buffers circulares y worker threads
  • 06Cero dependencias en tiempo de ejecución y tipos de TypeScript

Casos de uso

  • Añadir logging coherente a un servicio de Node.js con salida JSON en producción
  • Registrar logs desde un módulo compartido que se ejecuta tanto en el navegador como en el servidor
  • Enmascarar contraseñas y tokens antes de que los logs salgan del proceso
  • Enviar logs a un archivo, un recolector HTTP o un endpoint de OpenTelemetry

Inicio rápido

  1. 1

    Instala tslog desde npm

    npm install tslog
  2. 2

    Importa Logger y registra un mensaje

Antes de usarlo

  • Requiere Node.js 22 o posterior y solo funciona con ESM; no admite require() de CommonJS.
  • La versión 5 introduce un rediseño incompatible, por lo que actualizar desde v4 requiere cambios en el código.

Temas

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

Preguntas frecuentes

¿Qué es tslog?
Logger universal para TypeScript y JavaScript, con salida legible en terminal, JSON estructurado con los campos al principio, enmascaramiento de secretos y cero dependencias en tiempo de ejecución. tslog es una biblioteca de logging para TypeScript y JavaScript que funciona en Node.js, navegadores, Deno, Bun, workers y React Native con una sola API. De forma predeterminada, muestra texto legible y con colores en terminales interactivos, y texto plano cuando la salida se redirige mediante pipes o se ejecuta en CI. También se puede habilitar un formato JSON plano, con los campos al principio, para los pipelines de logs de producción.
¿tslog es gratuito? ¿Qué licencia tiene?
tslog es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿tslog sigue mantenido?
Mantenimiento activo. El último commit de tslog fue el 20 oct 2026.
¿Para qué puedo usar tslog?
Añadir logging coherente a un servicio de Node.js con salida JSON en producción Registrar logs desde un módulo compartido que se ejecuta tanto en el navegador como en el servidor Enmascarar contraseñas y tokens antes de que los logs salgan del proceso Enviar logs a un archivo, un recolector HTTP o un endpoint de OpenTelemetry
¿Cómo se instala tslog?
Instala tslog desde npm: npm install tslog Importa Logger y registra un mensaje
¿Dónde consigo tslog?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/fullstack-build/tslog

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados