# intercept-stdout

> Hooking Node.js stdout

Latest version **0.1.2** (published 2015-07-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install intercept-stdout
pnpm add intercept-stdout
yarn add intercept-stdout
bun add intercept-stdout
```

## Health

**Score 23/100 (F)** — status: abandoned.

Positive: has types package; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.2 |
| Published | 2015-07-29 |
| First published | 2014-01-28 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | separate (@types/intercept-stdout) |
| Module format | CommonJS |
| Dependencies | 1 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 67 |
| Author | Steven Farthing |
| Maintainers | stevefar |
| Keywords | stdout, stderr |

## Links

- npm: https://www.npmjs.com/package/intercept-stdout
- Repository: https://github.com/sfarthin/intercept-stdout
- Issues: https://github.com/sfarthin/intercept-stdout/issues
- npm.io page: https://npm.io/package/intercept-stdout

## Dependencies (1)

- [lodash.toarray](https://npm.io/package/lodash.toarray.md) ^3.0.0

## Recent versions

- 0.1.2 (latest) — 2015-07-29
- 0.1.1 — 2015-05-19
- 0.0.3 — 2015-02-17
- 0.0.2 — 2014-01-28
- 0.0.1 — 2014-01-28

## README

# Node.js Intercept stdout

> intercept-stdout captures or modifies stdout and/or stderr.

> _<sup>Based on [this](https://gist.github.com/benbuckman/2758563) gist</sup>_

## Capture
```javascript
var intercept = require("intercept-stdout"),
	captured_text = "";

var unhook_intercept = intercept(function(txt) {
	captured_text += txt;
});

console.log("This text is being captured");

// Let's stop capturing stdout.
unhook_intercept();

console.log("This text is not being captured");
```

## Modify
```javascript
var intercept = require("intercept-stdout");

var unhook_intercept = intercept(function(txt) {
	return txt.replace( /this/i , 'that' );
});

console.log("This text is being modified");
// -> that text is being modified
```

## Test

	npm install
	npm test

## Separating Error Text

Starting in Version 0.1.2, you may now specify two interceptor callbacks. If a second interceptor callback is specified, the second callback will be invoked for `stderr` output.

## Errors and Warnings

Versions > 0.1.1 hook both `stdout` and `stderr`. This change enables capturing of `console.log`, `console.info`, `console.warn`, and `console.error`. This change may break pre-existing interceptors if your interceptor expected output to be a full line of text.

## About Colorization

Popular modules such as [`mocha`](http://mochajs.org/) and [`winston`](https://github.com/winstonjs/winston) may colorize output by inserting ANSI escape codes into the output stream. Both `mocha` and `winston` make multiple calls to the output streams while colorizing a line -- in order to be robust, your code should anticipate and deal with this.

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