fs.access docs inconsistency with files/directories

[cpojer]

• Version: 6

The docs say:
fs.R_OK - File can be read by the calling process.

However, fs.accessSync('path/to/directory', fs.R_OK) will succeed if the path maps to a directory instead of a file. I don't know if this is the expected behavior of accessSync but at least there should be a clarification in the documentation. Currently the documentation reads like it would succeed only for files and not for directories.

See: https://nodejs.org/api/fs.html#fs_fs_access_path_mode_callback

[cjihrig]

Documentation PRs are welcome :-)

[cpojer]

It makes sense first to figure out whether the intent of access is to work on directories and files the same.

[cjihrig]

The intent is to work the same.

[lance]

Presumably, that's the intent for all modes, correct?

• fs.F_OK - File is visible to the calling process. This is useful for determining if a file exists, but says nothing about rwx permissions. Default if no mode is specified.
• fs.R_OK - File can be read by the calling process.
• fs.W_OK - File can be written by the calling process.
• fs.X_OK - File can be executed by the calling process. This has no effect on Windows (will behave like fs.F_OK).