doc: add a note on console stream behavior · nodejs/node@c842146

Original file line numberDiff line numberDiff line change

@@ -19,7 +19,11 @@ The module exports two specific components:

1919
2020

_**Warning**_: The global console object's methods are neither consistently

2121

synchronous like the browser APIs they resemble, nor are they consistently

22-

asynchronous like all other Node.js streams. See the [note on process I/O][] for

22+

asynchronous like all other Node.js streams. Programs that desire to depend

23+

on the synchronous / asynchronous behavior of the console functions should

24+

first figure out the nature of console's backing stream. This is because the

25+

stream is dependent on the underlying platform and standard stream

26+

configuration of the current process. See the [note on process I/O][] for

2327

more information.

2428
2529

Example using the global `console`: