Logger

core. Logger

Provides console logging with configurable levels, colours, and module-specific overrides.

Constructor

new Logger(options)

Description:
  • Creates a Logger instance from config values
Source:
Parameters:
Name Type Description
options Object
Properties
Name Type Description
levels Array.<String> Log level config strings. An empty array mutes all output.
showTimestamp Boolean Whether to show timestamps

Members

logHook :Hook

Description:
  • Hook invoked on each message logged
Source:
Hook invoked on each message logged
Type:
  • Hook

Methods

log(level, id, …args)

Description:
  • Logs a message to the console. When `args[0]` is a string it's treated as a short id for line-level filtering (e.g. `'verbose.server.ADD_ROUTE'`).
Source:
Parameters:
Name Type Attributes Description
level String Severity of the message
id String Identifier for the message (typically the module name)
args * <repeatable>
 Arguments to be logged

(static) getIdOverrides(levelsConfig) → {Array.<String>}

Description:
  • Returns id-wide overrides — entries whose first segment isn't a known level, meaning they apply to that id at every level (e.g. `core` / `!core`).
Source:
Parameters:
Name Type Description
levelsConfig Array.<String> Array of level configuration strings
Returns:
Type
Array.<String>

(static) getLineOverrides(levelsConfig, level) → {Array.<String>}

Description:
  • Returns per-level line overrides (e.g. `debug.core.LOAD` / `!debug.core.LOAD`).
Source:
Parameters:
Name Type Description
levelsConfig Array.<String> Array of level configuration strings
level String The log level to find overrides for
Returns:
Type
Array.<String>

(static) getModuleOverrides(levelsConfig, level) → {Array.<String>}

Description:
  • Returns per-level module overrides (e.g. `debug.core` / `!debug.core`).
Source:
Parameters:
Name Type Description
levelsConfig Array.<String> Array of level configuration strings
level String The log level to find overrides for
Returns:
Type
Array.<String>

(static) isLevelEnabled(levelsConfig, level) → {Boolean}

Description:
  • Determines whether a specific log level is enabled
Source:
Parameters:
Name Type Description
levelsConfig Array.<String> Array of level configuration strings
level String The log level to check
Returns:
Type
Boolean

(static) isLoggingEnabled(configLevels, level, id, shortIdopt, idOverridesopt) → {Boolean}

Description:
  • Returns whether a message should be logged. Resolution order, most-specific wins: line-level (`!level.id.shortId`) → per-level module (`!level.id`) → id-wide (`!id`) → global level.
Source:
Parameters:
Name Type Attributes Description
configLevels Object The resolved levels config object
level String Logging level
id String Id of log caller
shortId String <optional>
 Optional line-level id (typically `args[0]`)
idOverrides Array.<String> <optional>
 Id-wide override entries
Returns:
Type
Boolean