Class Log

Logger implementation that filters messages by severity level and forwards them to a target.

Implements

Interface

Index

Constructors

Properties

level name target

Methods

debug error fatal info log rescue trace warn

Constructors

constructor

new Log(
    name: string,
    options?: {
        level?: "trace" | "debug" | "info" | "warn" | "error" | "fatal";
        target?: Target.t;
    },
): Log
Creates a new Log instance.
Parameters
- name: string
  Name of the logger
- options: {
  level?: "trace" | "debug" | "info" | "warn" | "error" | "fatal";
  target?: Target.t;
  } = {}
  Configuration options
  - Optionallevel?: "trace" | "debug" | "info" | "warn" | "error" | "fatal"
    
    Minimum severity level to log (defaults to process.env.LOG or 'error')
  - Optionaltarget?: Target.t
    
    Target to send logs to (defaults to console)
Returns Log
- Defined in log.ts:136

Properties

level

level: "trace" | "debug" | "info" | "warn" | "error" | "fatal"

Current minimum severity level threshold

name

name: string

Name of the logger instance, included in log messages

target

target: Target.t

Target that handles the actual logging

Methods

debug

debug(...entries: unknown[]): void
Log a message with 'debug' severity.
Parameters
- ...entries: unknown[]
  Values to log
Returns void
Implementation of Interface.debug
- Defined in log.ts:166

error

error(...entries: unknown[]): void
Log a message with 'error' severity.
Parameters
- ...entries: unknown[]
  Values to log
Returns void
Implementation of Interface.error
- Defined in log.ts:178

fatal

fatal(...entries: unknown[]): void
Log a message with 'fatal' severity.
Parameters
- ...entries: unknown[]
  Values to log
Returns void
Implementation of Interface.fatal
- Defined in log.ts:182

info

info(...entries: unknown[]): void
Log a message with 'info' severity.
Parameters
- ...entries: unknown[]
  Values to log
Returns void
Implementation of Interface.info
- Defined in log.ts:170

log

log(
severity: "trace" | "debug" | "info" | "warn" | "error" | "fatal",
...entries: unknown[],
): void
Log a message with the specified severity level. Only logs if the severity is >= the current level.
Parameters
- severity: "trace" | "debug" | "info" | "warn" | "error" | "fatal"
  The severity level of the log message
- ...entries: unknown[]
  Values to log
Returns void
Implementation of Interface.log
- Defined in log.ts:154

rescue

rescue<T>(
    severity: "trace" | "debug" | "info" | "warn" | "error" | "fatal",
    message: string,
    result: T,
): (err: unknown) => T
Create an error handler that logs the error and returns a fallback value.
Type Parameters
- T
Parameters
- severity: "trace" | "debug" | "info" | "warn" | "error" | "fatal"
  The severity level to log the error with
- message: string
  The message to log with the error
- result: T
  The fallback value to return
Returns (err: unknown) => T
A function that logs errors and returns the fallback value
Implementation of Interface.rescue
- Defined in log.ts:186

trace

trace(...entries: unknown[]): void
Log a message with 'trace' severity.
Parameters
- ...entries: unknown[]
  Values to log
Returns void
Implementation of Interface.trace
- Defined in log.ts:162

warn

warn(...entries: unknown[]): void
Log a message with 'warn' severity.
Parameters
- ...entries: unknown[]
  Values to log
Returns void
Implementation of Interface.warn
- Defined in log.ts:174