# Empty Stream
> Create an "empty" [readable stream][readable-stream].
## Usage
```javascript
var emptyStream = require( '@stdlib/streams/node/empty' );
```
#### emptyStream( \[options] )
Returns an "empty" [readable stream][readable-stream] (i.e., a [stream][stream] which never streams any values).
```javascript
var inspectStream = require( '@stdlib/streams/node/inspect-sink' );
function log( chunk ) {
// This function should never be called...
console.log( chunk.toString() );
}
var stream = emptyStream();
var iStream = inspectStream( log );
stream.pipe( iStream );
```
The function accepts the following `options`:
- **objectMode**: specifies whether a [stream][stream] should operate in [objectMode][object-mode]. Default: `false`.
To set [stream][stream] `options`,
```javascript
var opts = {
'objectMode': true
};
var stream = emptyStream( opts );
```
* * *
#### emptyStream.factory( \[options] )
Returns a `function` for creating "empty" [readable streams][readable-stream].
```javascript
var opts = {
'objectMode': true
};
var createStream = emptyStream.factory( opts );
var stream1 = createStream();
var stream2 = createStream();
// ...
```
The method accepts the same `options` as [`emptyStream()`](#empty-stream).
* * *
#### emptyStream.objectMode()
This method is a convenience function to create "empty" [streams][stream] which **always** operate in [objectMode][object-mode].
```javascript
var inspectStream = require( '@stdlib/streams/node/inspect-sink' );
function log( v ) {
console.log( v );
}
var stream = emptyStream.objectMode();
var opts = {
'objectMode': true
};
var iStream = inspectStream( opts, log );
stream.pipe( iStream );
```
* * *
## Examples
```javascript
var inspectStream = require( '@stdlib/streams/node/inspect-sink' );
var emptyStream = require( '@stdlib/streams/node/empty' );
function log( v ) {
console.log( v.toString() );
}
var opts = {
'objectMode': true
};
var stream = emptyStream( opts );
opts = {
'objectMode': true
};
var iStream = inspectStream( opts, log );
stream.pipe( iStream );
```
* * *
## CLI
### Usage
```text
Usage: empty-stream [options]
Options:
-h, --help Print this message.
-V, --version Print the package version.
```
### Examples
```bash
$ empty-stream
```
[stream]: https://nodejs.org/api/stream.html
[object-mode]: https://nodejs.org/api/stream.html#stream_object_mode
[readable-stream]: https://nodejs.org/api/stream.html