diff --git a/doc/api/fs.md b/doc/api/fs.md index 2f15aeeb73c169..c0b28fc5073f1a 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -565,6 +565,11 @@ In general, check for the accessibility of a file only if the file will not be used directly, for example when its accessibility is a signal from another process. +On Windows, access-control policies (ACLs) on a directory may limit access to +a file or directory. The `fs.access()` function, however, does not check the +ACL and therefore may report that a path is accessible even if the ACL restricts +the user from reading or writing to it. + ## fs.accessSync(path[, mode])