1berry/nodejs
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

doc: document that stdio is usually blocking

Browse Source
This commit is contained in:
Ben Noordhuis 2013-03-23 15:38:17 +01:00
parent c3aae9cf95
commit 132c77e9f9
1 changed files with 13 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
doc/api/stdio.markdown
View File

@ -9,6 +9,19 @@
For printing to stdout and stderr. Similar to the console object functions For printing to stdout and stderr. Similar to the console object functions
provided by most web browsers, here the output is sent to stdout or stderr. provided by most web browsers, here the output is sent to stdout or stderr.
The console functions are synchronous when the destination is a terminal or
a file (to avoid lost messages in case of premature exit) and asynchronous
when it's a pipe (to avoid blocking for long periods of time).
That is, in the following example, stdout is non-blocking while stderr
is blocking:
$ node script.js 2> error.log | tee info.log
In daily use, the blocking/non-blocking dichotomy is not something you
should worry about unless you log huge amounts of data.
## console.log([data], [...]) ## console.log([data], [...])
Prints to stdout with newline. This function can take multiple arguments in a Prints to stdout with newline. This function can take multiple arguments in a