Manpages - logging.7

Table of Contents

NAME

Logging - Why, What & How we Log

Description

The npm CLI has various mechanisms for showing different levels of information back to end-users for certain commands, configurations & environments.

Setting Log Levels

loglevel

loglevel is a global argument/config that can be set to determine the type of information to be displayed.

The default value of loglevel is “notice” but there are several levels/types of logs available, including:

  • “silent”
  • “error”
  • “warn”
  • “notice”
  • “http”
  • “timing”
  • “info”
  • “verbose”
  • “silly”

All logs pertaining to a level proceeding the current setting will be shown.

All logs are written to a debug log, with the path to that file printed if the execution of a command fails.

Aliases

The log levels listed above have various corresponding aliases, including:

  • -d: –loglevel info
  • –dd: –loglevel verbose
  • –verbose: –loglevel verbose
  • –ddd: –loglevel silly
  • -q: –loglevel warn
  • –quiet: –loglevel warn
  • -s: –loglevel silent
  • –silent: –loglevel silent

foreground-scripts

The npm CLI began hiding the output of lifecycle scripts for npm install as of v7 . Notably, this means you will not see logs/output from packages that may be using “install scripts” to display information back to you or from your own project’s scripts defined in package.json . If you’d like to change this behavior & log this output you can set foreground-scripts to true .

Registry Response Headers

npm-notice

The npm CLI reads from & logs any npm-notice headers that are returned from the configured registry. This mechanism can be used by third-party registries to provide useful information when network-dependent requests occur.

This header is not cached, and will not be logged if the request is served from the cache.

See also

  • npm help config

Author: dt

Created: 2022-02-20 Sun 09:42