doc: document ACL limitation for fs.access on Windows

Fixes: #19192 PR-URL: #23772 Reviewed-By: Vse Mozhet Byt <[email protected]> Reviewed-By: Sam Roberts <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Bartosz Sosnowski <[email protected]>
nodejs · Nov 28, 2018 · 0ff88a3 · 0ff88a3
1 parent 32ae851
commit 0ff88a3
Showing 1 changed file with 5 additions and 0 deletions.
diff --git 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])
 <!-- YAML
 added: v0.11.15