doc: clarify glob's exclude option behavior

hotpineapple · targos · commit 9e76089f1a24 · 2025-08-21T19:01:06.000+02:00
Add a note that negation patterns are not supported. PR-URL: #59245 Reviewed-By: Moshe Atlow <moshe@atlow.co.il>
diff --git a/doc/api/fs.md b/doc/api/fs.md
@@ -1108,6 +1108,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
