From 7fa14fcf5473e73d66d6583eca1b4c70dca12e7f Mon Sep 17 00:00:00 2001 From: hotpineapple <77835382+hotpineapple@users.noreply.github.com> Date: Tue, 19 Aug 2025 01:28:00 +0900 Subject: [PATCH] doc: clarify glob's exclude option behavior Add a note that negation patterns are not supported. PR-URL: https://github.com/nodejs/node/pull/59245 Reviewed-By: Moshe Atlow --- doc/api/fs.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/doc/api/fs.md b/doc/api/fs.md index 2d542557c4a..8dd725b7774 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -1102,6 +1102,9 @@ changes: * `exclude` {Function|string\[]} Function to filter out files/directories or a list of glob patterns to be excluded. If a function is provided, return `true` to exclude the item, `false` to include it. **Default:** `undefined`. + If a string array is provided, each string should be a glob pattern that + specifies paths to exclude. Note: Negation patterns (e.g., '!foo.js') are + not supported. * `withFileTypes` {boolean} `true` if the glob should return paths as Dirents, `false` otherwise. **Default:** `false`. * Returns: {AsyncIterator} An AsyncIterator that yields the paths of files