nuxt/consola
Consola
Consola is a JavaScript logging library and pluggable framework that provides a cross-platform console wrapper. It enables unified output formatting and stream wrapping across both web browser and Node.js terminal environments.
The project distinguishes itself through a pluggable reporter system and the ability to intercept global system output, routing standard console and system streams through centralized logging handlers. It provides utilities for creating visually enhanced command line interfaces with support for tags and severity levels.
The framework covers wide-ranging observability capabilities, including log level filtering, volume throttling to prevent repeated message spam, and the generation of scoped loggers for module-specific tracking. It also includes mechanisms for queuing and pausing log emission and tools for simulating logger behavior via mock implementations for automated testing.
The library also integrates interactive user input prompts for creating command line interfaces that collect text, confirmation, and selection responses.
Features
- Cross-Environment Logging Interfaces - Provides a unified logging API that works consistently across both Node.js and web browser environments.
- Console Stream Capture - Captures standard console and system streams and routes them through a custom logger with restoration support.
- Global Console Interception - Captures global console and system output by replacing standard I/O streams with a custom handler.
- Logging Libraries - Offers a general-purpose toolkit for formatting and emitting styled log messages across JS environments.
- System Stream Interception - Intercepts system stdout and stderr streams to route all global console messages through a centralized handler.
- Cross-Platform Console Loggers - Wraps standard output and error streams to provide unified logging behavior for web and terminal applications.
- Pluggable Logger Frameworks - Provides a pluggable system for managing log reporters and redirecting global console output.
- Severity Level Filtering - Controls output verbosity by filtering messages based on severity levels against a defined threshold.
- Log Frequency Throttling - Prevents log flooding by limiting the rate of repeated message emission.
- Visual CLI Log Styling - Creates a consistent and visually styled logging experience for command line tools across environments.
- Global Output Interception - Intercepts global console and system output streams to route them through centralized logging handlers.
- Pluggable Logging Backends - Implements a pluggable architecture to route log data to interchangeable output destinations.
- Custom Log Writers - Provides a pluggable reporter system to route diagnostic messages to custom external logging destinations.
- Log Message Buffers - Temporarily stores log messages in a memory queue to avoid output during critical operations.
- Application Debugging - Supports application debugging by tracking program execution through scoped loggers and severity filters.
- Visual Layout Formatters - Provides a utility for creating visually enhanced command line interfaces with tags and severity levels.
- Console Log Styling - Renders logs with visually enhanced styles across command line and browser environments.
- Log Buffering and Pausing - Allows pausing log emission and queuing messages in memory to prevent output during critical operations.
- Formatted Console Outputs - Outputs messages using predefined styles and severity levels for a consistent visual experience.
- Named Scope Loggers - Creates logger instances that prepend identifiers to messages for module-specific tracking.
- Logger Behavior Simulation - Verifies application output during tests by using mock loggers to simulate logging behavior.
- Environment-Aware Rendering - Provides logic to switch between rich terminal styling and plain text based on the current execution environment.
- Logging - Elegant logging for Node and browser.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
