Welcome to mirror list, hosted at ThFree Co, Russian Federation.

README.md « proc-log « node_modules - github.com/npm/cli.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
blob: 1adc2a65849ddaf142df16b8939db8a14c37c580 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# proc-log

Emits 'log' events on the process object which a log output listener can
consume and print to the terminal.

This is used by various modules within the npm CLI stack in order to send
log events that [`npmlog`](http://npm.im/npmlog) can consume and print.

## API

* `log.error(...args)` calls `process.emit('log', 'error', ...args)`
  The highest log level.  For printing extremely serious errors that
  indicate something went wrong.
* `log.warn(...args)` calls `process.emit('log', 'warn', ...args)`
  A fairly high log level.  Things that the user needs to be aware of, but
  which won't necessarily cause improper functioning of the system.
* `log.notice(...args)` calls `process.emit('log', 'notice', ...args)`
  Notices which are important, but not necessarily dangerous or a cause for
  excess concern.
* `log.info(...args)` calls `process.emit('log', 'info', ...args)`
  Informative messages that may benefit the user, but aren't particularly
  important.
* `log.verbose(...args)` calls `process.emit('log', 'verbose', ...args)`
  Noisy output that is more detail that most users will care about.
* `log.silly(...args)` calls `process.emit('log', 'silly', ...args)`
  Extremely noisy excessive logging messages that are typically only useful
  for debugging.
* `log.http(...args)` calls `process.emit('log', 'http', ...args)`
  Information about HTTP requests made and/or completed.
* `log.pause(...args)` calls `process.emit('log', 'pause')`  Used to tell
  the consumer to stop printing messages.
* `log.resume(...args)` calls `process.emit('log', 'resume', ...args)`
  Used to tell the consumer that it is ok to print messages again.