doc: fs.readFile is async but not partitioned

This change was suggested during the discussion of #17054. PR-URL: #17154 Reviewed-By: James M Snell <[email protected]> Reviewed-By: Rich Trott <[email protected]> Reviewed-By: Gireesh Punathil <[email protected]> Reviewed-By: Vse Mozhet Byt <[email protected]>
nodejs · Dec 20, 2017 · ec1a35c · ec1a35c
1 parent 7e571ae
commit ec1a35c
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -1897,6 +1897,11 @@ Any specified file descriptor has to support reading.
 *Note*: If a file descriptor is specified as the `path`, it will not be closed
 automatically.
 
+*Note*: `fs.readFile()` reads the entire file in a single threadpool request.
+To minimize threadpool task length variation, prefer the partitioned APIs
+`fs.read()` and `fs.createReadStream()` when reading files as part of
+fulfilling a client request.
+
 ## fs.readFileSync(path[, options])
 <!-- YAML
 added: v0.1.8