Commit 0ff88a3
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 32ae851 commit 0ff88a3
1 file changed
Lines changed: 5 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -565,6 +565,11 @@ In general, check for the accessibility of a file only if the file will not be | |||
| 565 | 565 | used directly, for example when its accessibility is a signal from another | |
| 566 | 566 | process. | |
| 567 | 567 | ||
| 568 | + On Windows, access-control policies (ACLs) on a directory may limit access to | ||
| 569 | + a file or directory. The `fs.access()` function, however, does not check the | ||
| 570 | + ACL and therefore may report that a path is accessible even if the ACL restricts | ||
| 571 | + the user from reading or writing to it. | ||
| 572 | + | ||
| 568 | 573 | ## fs.accessSync(path[, mode]) | |
| 569 | 574 | <!-- YAML | |
| 570 | 575 | added: v0.11.15 | |
0 commit comments