Class Logger

Hierarchy

EventEmitter<{
 debug: [data: string];
 entry: [data: string, level: LogLevel];
 error: [data: string | Error];
 info: [data: string];
 log: [data: string];
 send: [data: IOMessage];
 warn: [data: string | Error];
}>
- Logger

Index

Constructors

constructor

new Logger(options?): Logger
Parameters
- options: Partial<LoggerOptions> = {}
Returns Logger
Overrides EventEmitter<{ entry: [data: string, level: LogLevel]; log: [data: string]; info: [data: string]; warn: [data: string | Error]; error: [data: string | Error]; debug: [data: string]; send: [data: IOMessage]; }>.constructor
- Defined in src/logger.ts:71

Properties

`Protected` _entries

_entries: string[] = []

`Protected` `Readonly` io

io: Set<IO<SupportedInterface>> = ...

`Protected` options

options: Partial<LoggerOptions> = {}

`Static` prefixed

prefixed: string | boolean

Accessors

attachedIO

get attachedIO(): number
Get the number of attached streams

Returns number
number of attached streams
- Defined in src/logger.ts:91

entries

get entries(): string[]
Gets the array of log entries. Empty if retainLogs is false.

Returns string[]
A copy of the log entries array.
- Defined in src/logger.ts:83

Methods

addListener

addListener<T>(event, fn, context?): this
Type Parameters
- T extends "send" | "log" | "info" | "warn" | "error" | "debug" | "entry"
Parameters
- event: T
- fn: ((...args) => void)
 - - (...args): void
 - Parameters
 Rest ...args: ArgumentMap<{
 debug: [data: string];
 entry: [data: string, level: LogLevel];
 error: [data: string | Error];
 info: [data: string];
 log: [data: string];
 send: [data: IOMessage];
 warn: [data: string | Error];
 }>[Extract<T, "send" | "log" | "info" | "warn" | "error" | "debug" | "entry">]
 Returns void
- Optional context: any
Returns this
Inherited from EventEmitter.addListener
- Defined in node_modules/eventemitter3/index.d.ts:45

attach

attach(io, inputLevels, outputLevels, prefix?): void
Attaches an input or output to the Logger
Parameters
- io: Logger
  The interface to attach.
- inputLevels: LogLevel[]
  The log levels to use from the i/o
- outputLevels: LogLevel[]
  The log levels to use from the i/o If log levels are not provided, all log levels will be attached.
- Optional prefix: string
Returns void
- Defined in src/logger.ts:103
attach(io, levels?, prefix?): void
Type Parameters
- I extends SupportedInterface
Parameters
- io: I
- Optional levels: LogLevel[]
- Optional prefix: string
Returns void
- Defined in src/logger.ts:104
attach(io): void
Type Parameters
- I extends SupportedInterface
Parameters
- io: IO
Returns void
- Defined in src/logger.ts:105

clear

clear(): boolean
Clears retained log entries

Returns boolean
whether the entries where cleared or not
- Defined in src/logger.ts:240

clearIO

clearIO(): void
Detaches all I/O

Returns void
- Defined in src/logger.ts:176

debug

debug(...data): void
Logs a debug message with the LogLevel.DEBUG level.
Parameters
- Rest ...data: string[]
  The log message.
Returns void
- Defined in src/logger.ts:297

detach

detach(io, inputLevels, outputLevels): void
Detaches an input or output from the Logger
Parameters
- io: Logger
  The interface to detach.
- inputLevels: LogLevel[]
  The log levels to use from the i/o
- outputLevels: LogLevel[]
  The log levels to use from the i/o If log levels are not provided, all log levels will be detached.
Returns void
- Defined in src/logger.ts:151
detach(io, levels?): void
Type Parameters
- I extends SupportedInterface
Parameters
- io: I
- Optional levels: LogLevel[]
Returns void
- Defined in src/logger.ts:152
detach(io): void
Type Parameters
- I extends SupportedInterface
Parameters
- io: IO
Returns void
- Defined in src/logger.ts:153

emit

emit<T>(event, ...args): boolean
Calls each of the listeners registered for a given event.
Type Parameters
- T extends "send" | "log" | "info" | "warn" | "error" | "debug" | "entry"
Parameters
- event: T
- Rest ...args: ArgumentMap<{
 debug: [data: string];
 entry: [data: string, level: LogLevel];
 error: [data: string | Error];
 info: [data: string];
 log: [data: string];
 send: [data: IOMessage];
 warn: [data: string | Error];
 }>[Extract<T, "send" | "log" | "info" | "warn" | "error" | "debug" | "entry">]
Returns boolean
Inherited from EventEmitter.emit
- Defined in node_modules/eventemitter3/index.d.ts:32

error

error(data): Error
Logs an error message with the LogLevel.ERROR level.
Parameters
- data: string | Error
  The error or log message.
Returns Error
- Defined in src/logger.ts:285

eventNames

eventNames(): ("send" | "log" | "info" | "warn" | "error" | "debug" | "entry")[]
Return an array listing the events for which the emitter has registered listeners.

Returns ("send" | "log" | "info" | "warn" | "error" | "debug" | "entry")[]
Inherited from EventEmitter.eventNames
- Defined in node_modules/eventemitter3/index.d.ts:15

info

info(...data): void
Logs a info message with the LogLevel.INFO level.
Parameters
- Rest ...data: string[]
  The log message.
Returns void
- Defined in src/logger.ts:264

listenerCount

listenerCount(event): number
Return the number of listeners listening to a given event.
Parameters
- event: "send" | "log" | "info" | "warn" | "error" | "debug" | "entry"
Returns number
Inherited from EventEmitter.listenerCount
- Defined in node_modules/eventemitter3/index.d.ts:27

listeners

listeners<T>(event): ((...args) => void)[]
Return the listeners registered for a given event.
Type Parameters
- T extends "send" | "log" | "info" | "warn" | "error" | "debug" | "entry"
Parameters
- event: T
Returns ((...args) => void)[]
Inherited from EventEmitter.listeners
- Defined in node_modules/eventemitter3/index.d.ts:20

log

log(...data): void
Logs a message with the LogLevel.LOG level.
Parameters
- Rest ...data: string[]
  The log message.
Returns void
- Defined in src/logger.ts:255

off

off<T>(event, fn?, context?, once?): this
Type Parameters
- T extends "send" | "log" | "info" | "warn" | "error" | "debug" | "entry"
Parameters
- event: T
- Optional fn: ((...args) => void)
 - - (...args): void
 - Parameters
 Rest ...args: ArgumentMap<{
 debug: [data: string];
 entry: [data: string, level: LogLevel];
 error: [data: string | Error];
 info: [data: string];
 log: [data: string];
 send: [data: IOMessage];
 warn: [data: string | Error];
 }>[Extract<T, "send" | "log" | "info" | "warn" | "error" | "debug" | "entry">]
 Returns void
- Optional context: any
- Optional once: boolean
Returns this
Inherited from EventEmitter.off
- Defined in node_modules/eventemitter3/index.d.ts:69

on

on<T>(event, fn, context?): this
Add a listener for a given event.
Type Parameters
- T extends "send" | "log" | "info" | "warn" | "error" | "debug" | "entry"
Parameters
- event: T
- fn: ((...args) => void)
 - - (...args): void
 - Parameters
 Rest ...args: ArgumentMap<{
 debug: [data: string];
 entry: [data: string, level: LogLevel];
 error: [data: string | Error];
 info: [data: string];
 log: [data: string];
 send: [data: IOMessage];
 warn: [data: string | Error];
 }>[Extract<T, "send" | "log" | "info" | "warn" | "error" | "debug" | "entry">]
 Returns void
- Optional context: any
Returns this
Inherited from EventEmitter.on
- Defined in node_modules/eventemitter3/index.d.ts:40

once

once<T>(event, fn, context?): this
Add a one-time listener for a given event.
Type Parameters
- T extends "send" | "log" | "info" | "warn" | "error" | "debug" | "entry"
Parameters
- event: T
- fn: ((...args) => void)
 - - (...args): void
 - Parameters
 Rest ...args: ArgumentMap<{
 debug: [data: string];
 entry: [data: string, level: LogLevel];
 error: [data: string | Error];
 info: [data: string];
 log: [data: string];
 send: [data: IOMessage];
 warn: [data: string | Error];
 }>[Extract<T, "send" | "log" | "info" | "warn" | "error" | "debug" | "entry">]
 Returns void
- Optional context: any
Returns this
Inherited from EventEmitter.once
- Defined in node_modules/eventemitter3/index.d.ts:54

removeAllListeners

removeAllListeners(event?): this
Remove all listeners, or those of the specified event.
Parameters
- Optional event: "send" | "log" | "info" | "warn" | "error" | "debug" | "entry"
Returns this
Inherited from EventEmitter.removeAllListeners
- Defined in node_modules/eventemitter3/index.d.ts:79

removeListener

removeListener<T>(event, fn?, context?, once?): this
Remove the listeners of a given event.
Type Parameters
- T extends "send" | "log" | "info" | "warn" | "error" | "debug" | "entry"
Parameters
- event: T
- Optional fn: ((...args) => void)
 - - (...args): void
 - Parameters
 Rest ...args: ArgumentMap<{
 debug: [data: string];
 entry: [data: string, level: LogLevel];
 error: [data: string | Error];
 info: [data: string];
 log: [data: string];
 send: [data: IOMessage];
 warn: [data: string | Error];
 }>[Extract<T, "send" | "log" | "info" | "warn" | "error" | "debug" | "entry">]
 Returns void
- Optional context: any
- Optional once: boolean
Returns this
Inherited from EventEmitter.removeListener
- Defined in node_modules/eventemitter3/index.d.ts:63

send

send(contents, level): void
Outputs a log message to attached outputs.
Parameters
- contents: string
  The log message to be sent.
- level: LogLevel
  The log level for the message. Defaults to LogLevel.LOG.
Returns void
- Defined in src/logger.ts:186
send(message): void
Outputs a log message to attached outputs.
Parameters
- message: IOMessage
  The message
Returns void
- Defined in src/logger.ts:192

toString

toString(): string
Converts the log entries to a string.

Returns string
A string representation of the log entries.
- Defined in src/logger.ts:232

warn

warn(data): Error
Logs a warning message with the LogLevel.WARN level.
Parameters
- data: string | Error
  The error or log message.
Returns Error
- Defined in src/logger.ts:273

Class Logger

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns Logger

Properties

Protected _entries

Protected Readonly io

Protected options

Static prefixed

Accessors

attachedIO

Returns number

entries

Returns string[]

Methods

addListener

Type Parameters

Parameters

Parameters

Returns void

Returns this

attach

Parameters

Returns void

Type Parameters

Parameters

Returns void

Type Parameters

Parameters

Returns void

clear

Returns boolean

clearIO

Returns void

debug

Parameters

Returns void

detach

Parameters

Returns void

Type Parameters

Parameters

Returns void

Type Parameters

Parameters

Returns void

emit

Type Parameters

Parameters

Returns boolean

error

Parameters

Returns Error

eventNames

Returns ("send" | "log" | "info" | "warn" | "error" | "debug" | "entry")[]

info

Parameters

Returns void

listenerCount

Parameters

Returns number

listeners

Type Parameters

Parameters

Returns ((...args) => void)[]

log

Parameters

Returns void

off

Type Parameters

Parameters

Parameters

Returns void

`Protected` _entries

`Protected` `Readonly` io

`Protected` options

`Static` prefixed