6 declarations
(value: string | undefined): LogLevel | undefined Parses and validates a log level string.
valueThe value to parse as a log level
string | undefinedLogLevel | undefined The validated log level, or undefined if value is undefined
Error - if value is provided but invalid(level: LogLevel): number Converts a log level to its numeric value for comparison. Higher numbers indicate more verbose logging.
levelThe log level to convert
number Numeric value (0-4)
LogConsole Console interface subset used by Logger for output. Allows custom console implementations for testing.
Simple, flexible logger with support for child loggers and automatic context.
Features: - Instance-based configuration (no global state) - Child loggers with automatic label concatenation - Parent chain inheritance for level, console, and colors - Respects NO_COLOR environment variable
labeltype string
parenttype Logger
constructorCreates a new Logger instance.
type new (label?: string | undefined, options?: LoggerOptions): Logger
label?Optional label for this logger. Can be undefined for no label, or an
empty string '' which is functionally equivalent (both produce no brackets in output).
Note: Empty strings are only allowed for root loggers - child loggers cannot have empty labels.
string | undefinedoptionsOptional configuration for level, colors, and console
{}clear_level_overrideClears the level override for this logger, restoring inheritance from parent. After calling this, the logger will dynamically inherit the level from its parent (or use the default level if it has no parent).
type (): void
voidclear_colors_overrideClears the colors override for this logger, restoring inheritance from parent. After calling this, the logger will dynamically inherit colors from its parent (or use the default colors behavior if it has no parent).
type (): void
voidclear_console_overrideClears the console override for this logger, restoring inheritance from parent. After calling this, the logger will dynamically inherit the console from its parent (or use the global console if it has no parent).
type (): void
voidchildCreates a child logger with automatic label concatenation. Children inherit parent configuration unless overridden.
type (label: string, options?: LoggerOptions): Logger
labelChild label (will be concatenated with parent label using :).
Cannot be an empty string - empty labels would result in confusing output like parent:
with a trailing colon. Use undefined or '' only for root loggers.
stringoptionsOptional configuration overrides
{}New Logger instance with concatenated label
Error - if label is an empty stringerrorLogs an error message with 🞩error🞩 prefix.
Only outputs if current level is error or higher.
type (...args: unknown[]): void
argsunknown[]voidwarnLogs a warning message with âš‘warnâš‘ prefix.
Only outputs if current level is warn or higher.
type (...args: unknown[]): void
argsunknown[]voidinfoLogs an informational message.
Unlike error/warn/debug, info has no character prefix - only the label is shown.
This keeps standard output clean since info is the default log level.
Only outputs if current level is info or higher.
type (...args: unknown[]): void
argsunknown[]voiddebugLogs a debug message with ┆debug┆ prefix.
Only outputs if current level is debug.
type (...args: unknown[]): void
argsunknown[]voidrawLogs raw output without any prefix, formatting, or level filtering. Bypasses the logger's level checking, prefix formatting, and color application entirely. Useful for outputting structured data or when you need full control over formatting.
Note: This method ignores the configured log level - it always outputs regardless of whether the logger is set to 'off' or any other level.
type (...args: unknown[]): void
argsValues to log directly to console
unknown[]voidLoggerOptions levelLog level for this logger instance. Inherits from parent or defaults to 'info'.
consoleConsole interface for output. Inherits from parent or defaults to global console. Useful for testing.
colorsWhether to use colors in output. Inherits from parent or defaults to enabled (unless NO_COLOR env var is set).
booleanLogLevel Log level hierarchy from least to most verbose.
- 'off': No logging
- 'error': Only errors
- 'warn': Errors and warnings
- 'info': Errors, warnings, and info (default)
- 'debug': All messages including debug