Repolode
Предложить
debug-js

debug-js/debug

Небольшая утилита для отладки JavaScript: выводит логи с пространствами имён в Node.js и браузерах и включается через переменную окружения DEBUG.

Открыть на GitHub
Звёзды
11,458
Форки
998
Открытые issues
98
Последний коммит
11 дней назад

Что это?

debug — компактная утилита для логирования в JavaScript, созданная по образцу приёма отладки, используемого в ядре Node.js. Создайте именованную debug-функцию с пространством имён, например 'http' или 'worker:a': вывод появится, только если это пространство имён включено через переменную окружения DEBUG. Шаблоны с подстановочными знаками и исключениями, например DEBUG=connect:* или DEBUG=*,-connect:*, позволяют ограничить вывод отдельными частями приложения.

Библиотека работает и в Node.js, и в веб-браузерах. В Node.js она выводит данные в stderr, поддерживает отдельные цвета для пространств имён и показывает разницу во времени между вызовами в миллисекундах. В браузерах состояние включения хранится в localStorage. Поддерживаются форматтеры в стиле printf, такие как %o, %O, %s, %d и %j; собственные форматтеры можно добавить, расширив debug.formatters.

Также доступны API для расширения пространств имён, проверки, включено ли пространство имён, а также для включения и отключения вывода во время работы.

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

  • 01Именованные debug-функции, включаемые через переменную окружения DEBUG.
  • 02Шаблоны с подстановочными знаками и исключениями для фильтрации вывода.
  • 03Работает в Node.js и веб-браузерах; где поддерживается, использует цвета.
  • 04Показывает разницу во времени между вызовами в миллисекундах или выводит временные метки ISO, если вывод направлен не в TTY.
  • 05Форматтеры в стиле printf с поддержкой пользовательских форматтеров.
  • 06API для включения, отключения и расширения во время работы.

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

  • Добавление в библиотеку или приложение на Node.js отладочных логов, которые можно включать по необходимости и которые по умолчанию не создают лишнего шума.
  • Отслеживание обработки запросов или активности воркеров в серверном процессе с помощью пространств имён.
  • Отладка фронтенд-кода в браузере с помощью настройки localStorage.debug.

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

  1. 1

    Установите пакет с помощью npm

    npm install debug
  2. 2

    Создайте в коде экземпляр debug с пространством имён, затем запустите приложение с включённым DEBUG (macOS/Linux)

    DEBUG=* node app.js

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

  • Вывод Debug отображается только для пространств имён, включённых через переменную окружения DEBUG или localStorage.debug.
  • Для поддержки всей палитры цветов в Node.js требуется необязательный модуль supports-color.

В подборках

OpenTelemetry и платформы наблюдаемости

Темы

#javascript#logging#debugging#node#browser#debug-logging#debug#node-js

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

Что такое debug?
Небольшая утилита для отладки JavaScript: выводит логи с пространствами имён в Node.js и браузерах и включается через переменную окружения DEBUG. debug — компактная утилита для логирования в JavaScript, созданная по образцу приёма отладки, используемого в ядре Node.js. Создайте именованную debug-функцию с пространством имён, например 'http' или 'worker:a': вывод появится, только если это пространство имён включено через переменную окружения DEBUG. Шаблоны с подстановочными знаками и исключениями, например DEBUG=connect:* или DEBUG=*,-connect:*, позволяют ограничить вывод отдельными частями приложения.
debug можно использовать бесплатно? Какая у него лицензия?
debug распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
debug всё ещё поддерживается?
Активно поддерживается. Последний коммит в debug — 14 окт. 2026 г..
Для чего можно использовать debug?
Добавление в библиотеку или приложение на Node.js отладочных логов, которые можно включать по необходимости и которые по умолчанию не создают лишнего шума. Отслеживание обработки запросов или активности воркеров в серверном процессе с помощью пространств имён. Отладка фронтенд-кода в браузере с помощью настройки localStorage.debug.
Как установить debug?
Установите пакет с помощью npm: npm install debug Создайте в коде экземпляр debug с пространством имён, затем запустите приложение с включённым DEBUG (macOS/Linux): DEBUG=* node app.js
Где скачать debug?
Исходный код и инструкции по установке — на GitHub: https://github.com/debug-js/debug

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты