fullstack-build/tslog

Что это?

Ключевые возможности

• 01Единый API для Node.js, браузеров, Deno, Bun, workers и React Native
• 02Удобный цветной вывод в терминале и обычный текст при перенаправлении; поддерживается JSON
• 03Маскирование секретов по имени ключа, JSON-пути, регулярному выражению или с помощью хешированного плейсхолдера
• 04Дочерние логгеры с унаследованными настройками и привязанными полями
• 05Подключаемые транспорты для файлов, HTTP, кольцевых буферов и worker threads
• 06Нет runtime-зависимостей; доступны типы TypeScript

Сценарии использования

• Добавление единообразного логирования в сервис Node.js с выводом JSON в production
• Логирование из общего модуля, который работает и в браузерном, и в серверном коде
• Маскирование паролей и токенов до отправки логов за пределы процесса
• Отправка логов в файл, HTTP-коллектор или эндпоинт OpenTelemetry

Быстрый старт

1. 1

   Установите tslog через npm

   npm install tslog
2. 2

   Импортируйте Logger и запишите сообщение в лог

Что важно знать

• !Требуется Node.js 22 или новее. Поддерживается только ESM, без CommonJS require().
• !В версии 5 переработана архитектура с несовместимыми изменениями, поэтому для обновления с v4 потребуется изменить код.

Темы

Частые вопросы

Что такое tslog?

Универсальный логгер для TypeScript и JavaScript: удобный вывод в терминал, JSON с полями в начале, маскирование секретов и отсутствие runtime-зависимостей. tslog — библиотека логирования для TypeScript и JavaScript с единым API для Node.js, браузеров, Deno, Bun, workers и React Native. По умолчанию она выводит цветные и удобочитаемые сообщения в интерактивном терминале, а при перенаправлении вывода или запуске в CI — обычный текст. Для production-пайплайнов логирования можно включить плоский формат JSON, в котором поля идут в начале.

tslog можно использовать бесплатно? Какая у него лицензия?

tslog распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

tslog всё ещё поддерживается?

Активно поддерживается. Последний коммит в tslog — 20 окт. 2026 г..

Для чего можно использовать tslog?

Добавление единообразного логирования в сервис Node.js с выводом JSON в production Логирование из общего модуля, который работает и в браузерном, и в серверном коде Маскирование паролей и токенов до отправки логов за пределы процесса Отправка логов в файл, HTTP-коллектор или эндпоинт OpenTelemetry

Как установить tslog?

Установите tslog через npm: npm install tslog Импортируйте Logger и запишите сообщение в лог

Где скачать tslog?

Исходный код и инструкции по установке — на GitHub: https://github.com/fullstack-build/tslog