This project is part of the
@thi.ng/umbrella monorepo.
About
Types & basis infrastructure for arbitrary logging (w/ default impls)
The types & implementations provided by this package are used in various places
throughout the thi.ng/umbrella ecosystem and can be swapped out on demand to
customize users' needs.
Log levels
All loggers based on this basic framework provided by this package support the
following LogLevel
s
(in order of importance):
Logging calls targetting lower levels than configured in the logger will be
ignored.
Supplied implementations
The following logger implementations are provided:
Lazy evaluation
Log messages can contain any number & types of arguments. No-arg functions can
be provided as message arg to avoid evaluation of potentially costly message
formatting for suppressed log levels. For example:
import { ConsoleLogger, LogLevel } from "@thi.ng/logger";
const logger = new ConsoleLogger("app", LogLevel.INFO);
const name = "thi.ng";
logger.info(`hello, ${name}`);
logger.debug("result is", 23 + 42);
logger.info("result is", () => 23 + 42);
Status
STABLE - used in production
Search or submit any issues for this package
Related packages
Installation
yarn add @thi.ng/logger
ES module import:
<script type="module" src="https://cdn.skypack.dev/@thi.ng/logger"></script>
Skypack documentation
For Node.js REPL:
const logger = await import("@thi.ng/logger");
Package sizes (brotli'd, pre-treeshake): ESM: 476 bytes
Dependencies
None
API
Generated API docs
TODO
Authors
If this project contributes to an academic publication, please cite it as:
@misc{thing-logger,
title = "@thi.ng/logger",
author = "Karsten Schmidt",
note = "https://thi.ng/logger",
year = 2016
}
License
© 2016 - 2022 Karsten Schmidt // Apache License 2.0