From 2ebb32b4806e2169338802fa3ba72b7e3d8354c3 Mon Sep 17 00:00:00 2001 From: Matteo Collina Date: Thu, 22 Nov 2018 17:36:17 +0100 Subject: [PATCH] doc: document fs.write limitation with TTY Fixes: https://github.com/nodejs/node/issues/24550 PR-URL: https://github.com/nodejs/node/pull/24571 Reviewed-By: Refael Ackermann Reviewed-By: Michael Dawson Reviewed-By: Gireesh Punathil Reviewed-By: Bartosz Sosnowski --- doc/api/fs.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/api/fs.md b/doc/api/fs.md index e73fd1ad26ed27..f7727e88008771 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -3528,6 +3528,13 @@ On Linux, positional writes don't work when the file is opened in append mode. The kernel ignores the position argument and always appends the data to the end of the file. +On Windows, if the file descriptor is connected to the console (e.g. `fd == 1` +or `stdout`) a string containing non-ASCII characters will not be rendered +properly by default, regardless of the encoding used. +It is possible to configure the console to render UTF-8 properly by changing the +active codepage with the `chcp 65001` command. See the [chcp][] docs for more +details. + ## fs.writeFile(file, data[, options], callback)