Class: Logger

logging.Logger(namenullable)

A Logger object is used to log messages for a specific system or application component.

Constructor

new Logger(namenullable)

Initializes a new logger with the given name.

Parameters:
Name Type Attributes Description
name string <nullable>

The name of the logger.

Members

(nullable) level :Level

The level of the logger.

If the level is not set, it will use the level of the parent logger.

Type:
  • Level

(nullable) name :string

The name of the logger.

Type:
  • string

parent :Logger

The parent logger.

The root logger has not a parent.

Type:
  • Logger

Methods

addHandler(handler)

Adds a log handler to receive logging messages.

Parameters:
Name Type Description
handler Handler

The handler to add.

debug(…message)

Logs a message with the DEBUG level.

Parameters:
Name Type Attributes Description
message * <repeatable>

The message to log.

error(…message)

Logs a message with the ERROR level.

Parameters:
Name Type Attributes Description
message * <repeatable>

The message to log.

getHandlers() → {Array.<Handler>}

Returns the handlers of the logger.

Returns:

The handlers of the logger.

Type
Array.<Handler>

info(…message)

Logs a message with the INFO level.

Parameters:
Name Type Attributes Description
message * <repeatable>

The message to log.

isLoggable(level) → {boolean}

Checks if a message of the given level would actually be logged by this logger.

Parameters:
Name Type Description
level Level

The level to check.

Returns:

true if the message would be logged.

Type
boolean

log(level, …message)

Logs a message.

Parameters:
Name Type Attributes Description
level Level

The level of the message.

message * <repeatable>

The message to log.

removeHandler(handler)

Removes a log handler.

Parameters:
Name Type Description
handler Handler

The handler to remove.

trace(…message)

Logs a message with the TRACE level.

Parameters:
Name Type Attributes Description
message * <repeatable>

The message to log.

trackMessagesLogged() → {OutputTracker}

Returns an output tracker for messages logged by this logger.

Returns:

The output tracker.

Type
OutputTracker

warning(…message)

Logs a message with the WARNING level.

Parameters:
Name Type Attributes Description
message * <repeatable>

The message to log.

(static) getAnonymousLogger(options) → {Logger}

Creates a new logger without any handlers.

Parameters:
Name Type Description
options Object

The options for the logger.

Properties
Name Type Description
level Level

The level of the logger.

Returns:

The logger.

Type
Logger

(static) getLogger(name) → {Logger}

Finds or creates a logger with the given name.

Parameters:
Name Type Description
name string

The name of the logger.

Returns:

The logger.

Type
Logger