René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"fs.glob is stable as of v24 but lacks any documentation regarding `pattern` argument","articleBody":"### Affected URL(s)\n\nhttps://nodejs.org/docs/latest/api/fs.html#fsglobpattern-options-callback \n\n### Description of the problem\n\nLove that native glob support came to node, however fs.glob is stable as of v24 but lacks documentation regarding `pattern` argument which is confusing, unhelpful and deterring adoption if you come from plethora of user land implementations. For once it prevents me from using it in my cli (edit files by glob patterns), because I can't tell to my cli's users how to write the patterns.\n\nI'm looking for documentation for glob's aspects: platform support, performance, supported features.\n\nI'd love to see following popular features mentioned. It will help to know if feature is supported or not, if there any caveats and examples showcasing how feature works.\n\n* Brace Expansion (`foo/{1..5}.md`, `bar/{a,b,c}.js`)\n* Extended glob matching, [extglobs](https://www.npmjs.com/package/micromatch#extglobs) (`+(x|y)`, `!(a|b)`)\n* \"Globstar\" ** matching, wildcards (`**`, `*.js`)\n* [Posix character classes](https://www.gnu.org/software/bash/manual/html_node/Pattern-Matching.html)  (`[[:alpha:][:digit:]]`)\n* Support for multiple glob patterns\n* Negation (`'!a/*.js'`, `'*!(b).js'`)\n* regex character classes (`foo-[1-5].js`)\n* regex logical \"or\" (`foo/(abc|xyz).js`)\n\nComparison examples with user land libraries like glob, minimatch, micromatch, fast-glob will be helpful too.\n\nMaybe text based matching (without `fs` or `path` involved) can be moved to `global` or `utils` packages and documented in depth there?","author":{"url":"https://github.com/iamstarkov","@type":"Person","name":"iamstarkov"},"datePublished":"2025-07-07T13:21:31.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":4},"url":"https://github.com/58981/node/issues/58981"}