Commit f4c4b2b
doc: document ACL limitation for fs.access on Windows
Fixes: #19192
PR-URL: #23772
Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com>
Reviewed-By: Sam Roberts <vieuxtech@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Bartosz Sosnowski <bartosz@janeasystems.com>1 parent 83b776c commit f4c4b2b
1 file changed
Lines changed: 5 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -980,6 +980,11 @@ In general, check for the accessibility of a file only if the file will not be | |||
| 980 | 980 | used directly, for example when its accessibility is a signal from another | |
| 981 | 981 | process. | |
| 982 | 982 | ||
| 983 | + On Windows, access-control policies (ACLs) on a directory may limit access to | ||
| 984 | + a file or directory. The `fs.access()` function, however, does not check the | ||
| 985 | + ACL and therefore may report that a path is accessible even if the ACL restricts | ||
| 986 | + the user from reading or writing to it. | ||
| 987 | + | ||
| 983 | 988 | ## fs.accessSync(path[, mode]) | |
| 984 | 989 | <!-- YAML | |
| 985 | 990 | added: v0.11.15 | |
0 commit comments