Skip to content

doc: qualify directory read ordering for native fs - #65868

Open
trivikr wants to merge 1 commit into
nodejs:mainfrom
trivikr:fs-dir-read-ordering
Open

doc: qualify directory read ordering for native fs#65868
trivikr wants to merge 1 commit into
nodejs:mainfrom
trivikr:fs-dir-read-ordering

Conversation

@trivikr

@trivikr trivikr commented Sep 7, 2026

Copy link
Copy Markdown
Member

Clarify that the documented directory-entry ordering behavior applies to directory reads handled by the native file system.

Mounted VFS paths may redirect node:fs operations to a provider. Such providers can construct Dirent objects from their own metadata without using the operating system's directory mechanisms, so the previous wording was too broad.

Clarify that the documented operating system directory ordering applies
to reads handled by the native file system.

Signed-off-by: Kamat, Trivikram <16024985+trivikr@users.noreply.github.com>
@nodejs-github-bot nodejs-github-bot added doc Issues and PRs related to Node.js documentation. fs Issues and PRs related to file-system APIs and the fs module. labels Sep 7, 2026
@trivikr trivikr added author ready PRs with CI started, the required approvals, and no outstanding review comments. commit-queue PRs queued for automated landing through the Commit Queue. labels Sep 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author ready PRs with CI started, the required approvals, and no outstanding review comments. commit-queue PRs queued for automated landing through the Commit Queue. doc Issues and PRs related to Node.js documentation. fs Issues and PRs related to file-system APIs and the fs module.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants