@docusaurus/logger

What is @docusaurus/logger?

@docusaurus/logger is a logging utility designed for use with Docusaurus, a popular static site generator. It provides a simple and consistent way to log messages with different levels of severity, such as info, warn, error, and success. The package is useful for developers who need to output logs during the build process or while running scripts related to Docusaurus projects.

What are @docusaurus/logger's main functionalities?

Info Logging

Logs an informational message. This is useful for general-purpose logging to inform the user about the progress or state of the application.

const logger = require('@docusaurus/logger');
logger.info('This is an info message');

Warning Logging

Logs a warning message. This is useful for indicating potential issues that are not critical but should be noted.

const logger = require('@docusaurus/logger');
logger.warn('This is a warning message');

Error Logging

Logs an error message. This is useful for reporting errors that occur during the execution of the application.

const logger = require('@docusaurus/logger');
logger.error('This is an error message');

Success Logging

Logs a success message. This is useful for indicating successful completion of tasks or operations.

const logger = require('@docusaurus/logger');
logger.success('This is a success message');

Other packages similar to @docusaurus/logger

winston

Winston is a versatile logging library for Node.js that supports multiple transports (e.g., console, file, HTTP). It is more feature-rich compared to @docusaurus/logger and is suitable for more complex logging requirements.

bunyan

Bunyan is a simple and fast JSON logging library for Node.js services. It provides a structured logging approach, which can be more powerful for analyzing logs compared to the simpler text-based logging of @docusaurus/logger.

pino

Pino is a low-overhead logging library for Node.js that focuses on performance. It is faster than many other logging libraries, including @docusaurus/logger, and is suitable for high-performance applications.

README

@docusaurus/logger

An encapsulated logger for semantically formatting console messages.

APIs

It exports a single object as default export: logger. logger has the following properties:

• Some useful colors.
• Formatters. These functions have the same signature as the formatters of picocolors. Note that their implementations are not guaranteed. You should only care about their semantics.
  • path: formats a file path or URL.
  • id: formats an identifier.
  • code: formats a code snippet.
  • subdue: subdues the text.
  • num: formats a number.
• The interpolate function. It is a template literal tag.
• Logging functions. All logging functions can both be used as functions (in which it has the same usage as console.log) or template literal tags.
  • info: prints information.
  • warn: prints a warning that should be payed attention to.
  • error: prints an error (not necessarily halting the program) that signals significant problems.
  • success: prints a success message.

Using the template literal tag

The template literal tag evaluates the template and expressions embedded. interpolate returns a new string, while other logging functions prints it. Below is a typical usage:

logger.info`Hello name=${name}! You have number=${money} dollars. Here are the ${
  items.length > 1 ? 'items' : 'item'
} on the shelf: ${items}
To buy anything, enter code=${'buy x'} where code=${'x'} is the item's name; to quit, press code=${'Ctrl + C'}.`;

An embedded expression is optionally preceded by a flag in the form %[a-z]+ (a percentage sign followed by a few lowercase letters). If it's not preceded by any flag, it's printed out as-is. Otherwise, it's formatted with one of the formatters:

• path=: path
• name=: id
• code=: code
• subdue=: subdue
• number=: num

If the expression is an array, it's formatted by `\n- ${array.join('\n- ')}\n` (note it automatically gets a leading line end). Each member is formatted by itself and the bullet is not formatted. So you would see the above message printed as: