Standard Error

Standard error.

Usage

var stderr = require( '@stdlib/streams/base/stderr' );

stderr

Standard error as a Writable stream.

// Write to the terminal...
stderr.write( 'Oh no!', 'utf8' );
// => 'Oh no!'

Notes

  • Unlike other streams, stderr can never be closed and, thus, never emits a 'finish' event.
  • Although rare, writes can block when output is redirected to a file.

Examples

var stdin = require( '@stdlib/streams/base/stdin' );
var stderr = require( '@stdlib/streams/base/stderr' );

// Set the encoding:
stdin.setEncoding( 'utf8' );

// Create an echo stream:
stdin.pipe( stderr );

// Push data to `stdin`:
stdin.push( 'beep' );
stdin.push( ' ' );
stdin.push( 'boop' );
stdin.push( '\n' );

// End the stream:
stdin.push( null );

// Ensure the process closes:
setTimeout( process.exit, 1000 );