# debuglog

> backport of util.debuglog from node v0.11

Latest version **1.0.1** (published 2014-03-05) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install debuglog
pnpm add debuglog
yarn add debuglog
bun add debuglog
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2014-03-05 |
| First published | 2013-07-05 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | * |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 22 |
| Author | Sam Roberts |
| Maintainers | octet |

## Links

- npm: https://www.npmjs.com/package/debuglog
- Repository: https://github.com/sam-github/node-debuglog
- Issues: https://github.com/sam-github/node-debuglog/issues
- npm.io page: https://npm.io/package/debuglog

## Recent versions

- 1.0.1 (latest) — 2014-03-05
- 1.0.0 — 2014-02-13
- 0.0.4 — 2014-02-13
- 0.0.3 — 2014-02-13
- 0.0.2 — 2013-10-29
- 0.0.1 — 2013-07-05

## README

# debuglog - backport of util.debuglog() from node v0.11

To facilitate using the `util.debuglog()` function that will be available when
node v0.12 is released now, this is a copy extracted from the source.

## require('debuglog')

Return `util.debuglog`, if it exists, otherwise it will return an internal copy
of the implementation from node v0.11.

## debuglog(section)

* `section` {String} The section of the program to be debugged
* Returns: {Function} The logging function

This is used to create a function which conditionally writes to stderr
based on the existence of a `NODE_DEBUG` environment variable.  If the
`section` name appears in that environment variable, then the returned
function will be similar to `console.error()`.  If not, then the
returned function is a no-op.

For example:

```javascript
var debuglog = util.debuglog('foo');

var bar = 123;
debuglog('hello from foo [%d]', bar);
```

If this program is run with `NODE_DEBUG=foo` in the environment, then
it will output something like:

    FOO 3245: hello from foo [123]

where `3245` is the process id.  If it is not run with that
environment variable set, then it will not print anything.

You may separate multiple `NODE_DEBUG` environment variables with a
comma.  For example, `NODE_DEBUG=fs,net,tls`.

---
_Source: https://npm.io/package/debuglog · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._