diff --git a/doc/api/fs.md b/doc/api/fs.md index 5b975202dac4ab..600f6db59bef4e 100644 --- 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])