time-to-botec/squiggle/node_modules/@stdlib/streams/node/debug/docs/repl.txt
NunoSempere b6addc7f05 feat: add the node modules
Necessary in order to clearly see the squiggle hotwiring.
2022-12-03 12:44:49 +00:00

129 lines
3.5 KiB
Plaintext

{{alias}}( [options,] [clbk] )
Returns a transform stream for debugging stream pipelines.
If the `DEBUG` environment variable is not set, no data is logged.
Providing a `name` option is *strongly* encouraged, as the `DEBUG`
environment variable can be used to filter debuggers.
Parameters
----------
options: Object (optional)
Options.
options.name: string (optional)
Debug namespace.
options.objectMode: boolean (optional)
Specifies whether a stream should operate in "objectMode". Default:
false.
options.highWaterMark: integer (optional)
Specifies the maximum number of bytes to store in an internal buffer
before ceasing to push downstream.
options.allowHalfOpen: boolean (optional)
Specifies whether a stream should remain open even if one side ends.
Default: false.
options.readableObjectMode: boolean (optional)
Specifies whether the readable side should be in "objectMode". Default:
false.
clbk: Function (optional)
Callback to invoke upon receiving data.
Returns
-------
stream: TransformStream
Transform stream.
Examples
--------
> var s = {{alias}}( { 'name': 'foo' } );
> s.write( 'a' );
> s.write( 'b' );
> s.write( 'c' );
> s.end();
{{alias}}.factory( [options] )
Returns a function for creating transform streams for debugging stream
pipelines.
Parameters
----------
options: Object (optional)
Options.
options.objectMode: boolean (optional)
Specifies whether a stream should operate in "objectMode". Default:
false.
options.highWaterMark: integer (optional)
Specifies the maximum number of bytes to store in an internal buffer
before ceasing to push downstream.
options.allowHalfOpen: boolean (optional)
Specifies whether a stream should remain open even if one side ends.
Default: false.
options.readableObjectMode: boolean (optional)
Specifies whether the readable side should be in "objectMode". Default:
false.
Returns
-------
createStream( name[, clbk] ): Function
Function for creating transform streams.
Examples
--------
> var opts = { 'objectMode': true, 'highWaterMark': 64 };
> var createStream = {{alias}}.factory( opts );
{{alias}}.objectMode( [options,] [clbk] )
Returns an "objectMode" transform stream for debugging stream pipelines.
Parameters
----------
options: Object (optional)
Options.
options.name: string (optional)
Debug namespace.
options.highWaterMark: integer (optional)
Specifies the maximum number of objects to store in an internal buffer
before ceasing to push downstream.
options.allowHalfOpen: boolean (optional)
Specifies whether a stream should remain open even if one side ends.
Default: false.
options.readableObjectMode: boolean (optional)
Specifies whether the readable side should be in "objectMode". Default:
false.
clbk: Function (optional)
Callback to invoke upon receiving data.
Returns
-------
stream: TransformStream
Transform stream operating in "objectMode".
Examples
--------
> var s = {{alias}}.objectMode( { 'name': 'foo' } );
> s.write( { 'value': 'a' } );
> s.write( { 'value': 'b' } );
> s.write( { 'value': 'c' } );
> s.end();
See Also
--------