You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
31 lines
1.5 KiB
31 lines
1.5 KiB
# set-blocking |
|
|
|
[](https://travis-ci.org/yargs/set-blocking) |
|
[](https://www.npmjs.com/package/set-blocking) |
|
[](https://coveralls.io/r/yargs/set-blocking?branch=master) |
|
[](https://github.com/conventional-changelog/standard-version) |
|
|
|
set blocking `stdio` and `stderr` ensuring that terminal output does not truncate. |
|
|
|
```js |
|
const setBlocking = require('set-blocking') |
|
setBlocking(true) |
|
console.log(someLargeStringToOutput) |
|
``` |
|
|
|
## Historical Context/Word of Warning |
|
|
|
This was created as a shim to address the bug discussed in [node #6456](https://github.com/nodejs/node/issues/6456). This bug crops up on |
|
newer versions of Node.js (`0.12+`), truncating terminal output. |
|
|
|
You should be mindful of the side-effects caused by using `set-blocking`: |
|
|
|
* if your module sets blocking to `true`, it will effect other modules |
|
consuming your library. In [yargs](https://github.com/yargs/yargs/blob/master/yargs.js#L653) we only call |
|
`setBlocking(true)` once we already know we are about to call `process.exit(code)`. |
|
* this patch will not apply to subprocesses spawned with `isTTY = true`, this is |
|
the [default `spawn()` behavior](https://nodejs.org/api/child_process.html#child_process_child_process_spawn_command_args_options). |
|
|
|
## License |
|
|
|
ISC
|
|
|