debug-js/debug
Debug
This project is a JavaScript logging utility and namespace-based debugger used for printing formatted, color-coded debug messages to the console in Node.js, web browsers, and Deno. It serves as a console output formatter and execution time profiler to help identify bugs and track program flow.
The system manages debug visibility through named namespaces, allowing specific groups of messages to be enabled or disabled via environment variables. It distinguishes different modules in the output stream by assigning specific colors to these namespaces.
The utility includes capabilities for measuring millisecond intervals between log calls to identify performance bottlenecks. It also supports placeholder-based string interpolation for data formatting and the redirection of log data to custom streams or output methods.
Features
- Console Log Formatters - Renders data types and objects in readable layouts using placeholders and custom formatters for console output.
- Namespace-Based Log Filtering - Provides a system to enable or disable specific groups of debug messages using named namespaces and environment variables.
- Performance Profiling Tools - Calculates millisecond intervals between log calls to identify performance bottlenecks.
- JavaScript and TypeScript Debugging - Identifies bugs and tracks program flow in JavaScript apps by logging specific module activity to the console.
- Namespace-Based Debuggers - Implements a logging system that enables or disables groups of messages using named namespaces and environment variables.
- Namespace-Based Log Filtering - Controls message visibility by matching specific string identifiers against an environment-defined list of active namespaces.
- Environment Variable-Based Configuration - Initializes active namespaces and settings by parsing system environment strings at runtime for zero-code configuration.
- Log Management - Controls which parts of a codebase output logs using named namespaces to reduce console noise during development.
- Logging Utilities - Provides a lightweight utility for printing formatted, color-coded debug messages to the console in Node.js and web browsers.
- Stream Redirection - Routes log data to a configurable stream or function instead of hardcoding a specific system output method.
- Console Color Mappings - Assigns specific ANSI or CSS colors to namespaces to visually distinguish different modules in the output stream.
- Browser Console Debugging - Adds structured and color-coded debug information to web browser consoles to make complex application states easier to read.
- Node.js Debuggers - Measures execution time and intervals between events in Node.js to find and fix performance bottlenecks.
- Custom Log Formatting - Renders logs using placeholders and custom formatters to display objects and data types in a readable layout.
- Message Interpolations - Formats messages by replacing custom markers with processed values passed as arguments to the logger.
- Function Execution Timing - Calculates the millisecond difference between consecutive debug calls to identify bottlenecks.
- Execution Time Profilers - Measures execution gaps by tracking the timestamp of the previous log call and calculating the difference.
- Debug Instance Controllers - Allows the creation of named debugging instances that toggle visibility via environment variables or dynamic method calls.
- Colored Log Formatters - Assigns colors to debug namespaces to visually separate different modules within the console output.
- Debug Log Filters - Uses wildcards and exclusion prefixes to include or omit specific groups of debuggers from the output.
- Logging - Listed in the “Logging” section of the Awesome Go awesome list.
- Debugging And Profiling - Lightweight utility for logging debug information.
