This package has been moved to @jalik/logger.
A flexible logger to log messages to anything you want (console, file, database...), there's nothing more to say about it.
Logging is an important part of an application lifecycle, from development to production, we always need to log messages for debugging or tracing errors and warnings.
This library is tested with unit tests.
The first thing to do is to create a logger, it's deadly simple.
import {Logger} from "jk-logger";
const Logger = new Logger({
// Activate the logger
active: true,
// Display message of given types in the console
console: {
debug: true,
error: true,
info: true,
other: true,
warning: true
},
// Display context in the console
displayContext: true
});
Note that options
are available on each Logger
instance via Logger.options
.
As you can imagine, there are different types of logging, this is useful to distinguish messages, so below are these types :
- debug : only used for debugging
- error : only used for errors and exceptions
- info : only used to display informative messages
- warning : only used to display warnings
You can access predefined logging types by importing them in your code.
import Types from "jk-logger/dist/types";
Types.debug;
Types.error;
Types.info;
Types.warning;
When you log a message, you can also provide an optional context as extra information, you have a dedicated method for each type of logging.
import {Logger} from "jk-logger";
const Logger = new Logger();
// Logs a debug message
Logger.debug("user json", {name: "karl"});
// Logs an error message
Logger.error("Forbidden", {error: new Error("forbidden")});
Logger.error(new Error("forbidden"));
// Logs an info message
Logger.info("Application started", {date: new Date()});
// Logs a warning message
Logger.warn("Disk usage is above 90%", {diskUsage: 92.6});
// Logs a custom type message
Logger.log("Plop", "custom-type");
By default a logger is activated, but you can deactivate it anytime you want by using the setActive(Boolean)
method.
import {Logger} from "jk-logger";
const Logger = new Logger();
// Activate logger on production environment only
Logger.setActive(process.env.NODE_ENV === "PRODUCTION");
// And to check if the logger is active
Logger.isActive();
The logger is flexible enough in the way that you can execute callbacks when an event occurs (debug, error, info, warning), so you could save logs to a database, a file or whatever you want.
import Types from "jk-logger/dist/types";
import {Logger} from "jk-logger";
const Logger = new Logger();
// With this event listener, you can do something when an error happens
Logger.on(Types.error, (message, context) => {
// do whatever you want here...
// save error to database, send an email...
});
// This will trigger the listener defined above
Logger.error("Cannot contact DNS server", {ipAddress: "8.8.8.8"});
- Adds options to activate or deactivate console logging for a type of message
- Adds option
Logger.options.console.debug = true
- Adds option
Logger.options.console.error = true
- Adds option
Logger.options.console.info = true
- Adds option
Logger.options.console.other = true
- Adds option
Logger.options.console.warning = true
- Adds option
Logger.options.displayContext = false
- First public release
The code is released under the MIT License.
If you find this lib useful and would like to support my work, donations are welcome :)