test/node_modules/stdout-stream/README.md
2018-12-13 14:35:49 +01:00

1,009 B

stdout-stream

Non-blocking stdout stream

npm install stdout-stream

build status dat

Rant

Try saving this example as example.js

console.error('start');
process.stdout.write(new Buffer(1024*1024));
console.error('end');

And run the following program

node example.js | sleep 1000

The program will never print end since stdout in node currently is blocking - even when its being piped (!).

stdout-stream tries to fix this by being a stream that writes to stdout but never blocks

Usage

var stdout = require('stdout-stream');

stdout.write('hello\n'); // write should NEVER block
stdout.write('non-blocking\n')
stdout.write('world\n');

stdout-stream should behave in the same way as process.stdout (i.e. do not end on pipe etc)

License

MIT