fs: expose glob and globSync

Author: MoLow

doc/api/fs.md

@@ -1069,6 +1069,38 @@ including subdirectories and files.
 When copying a directory to another directory, globs are not supported and
 behavior is similar to `cp dir1/ dir2/`.
 
+### `fsPromises.glob(patten[, options])`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+> Stability: 1 - Experimental
+
+* `patten` {string|string\[]}
+* `options` {Object}
+  * `cwd` {string} working directory. **Default:** `process.cwd()`
+  * `exclude` {Function} Function to filter out files/directories. Return
+    `true` to exclude the item, `false` to include it. **Default:** `undefined`.
+* Returns: {AsyncIterator} An AsyncIterator that yields the paths of files
+  that match the pattern.
+
+```mjs
+import { glob } from 'node:fs/promises';
+
+for await (const entry of glob('**/*.js'))
+  console.log(entry);
+```
+
+```cjs
+const { glob } = require('node:fs/promises');
+
+(async () => {
+  for await (const entry of glob('**/*.js'))
+    console.log(entry);
+})();
+```
+
 ### `fsPromises.lchmod(path, mode)`
 
 <!-- YAML
@@ -5529,6 +5561,33 @@ changes:
 
 Synchronous version of [`fs.futimes()`][]. Returns `undefined`.
 
+### `fs.globSync(patten[, options])`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+> Stability: 1 - Experimental
+
+* `patten` {string|string\[]}
+* `options` {Object}
+  * `cwd` {string} working directory. **Default:** `process.cwd()`
+  * `exclude` {Function} Function to filter out files/directories. Return
+    `true` to exclude the item, `false` to include it. **Default:** `undefined`.
+* Returns: {string\[]} paths of files that match the pattern.
+
+```mjs
+import { globSync } from 'node:fs';
+
+console.log(globSync('**/*.js'));
+```
+
+```cjs
+const { globSync } = require('node:fs');
+
+console.log(globSync('**/*.js'));
+```
+
 ### `fs.lchmodSync(path, mode)`
 
 <!-- YAML

lib/fs.js

@@ -86,6 +86,8 @@ const {
 const { toPathIfFileURL } = require('internal/url');
 const {
   customPromisifyArgs: kCustomPromisifyArgsSymbol,
+  emitExperimentalWarning,
+  getLazy,
   kEmptyObject,
   promisify: {
     custom: kCustomPromisifiedSymbol,
@@ -142,6 +144,7 @@ const {
   validateInteger,
   validateObject,
   validateString,
+  validateStringArray,
   kValidateObjectAllowNullable,
 } = require('internal/validators');
 
@@ -3102,6 +3105,22 @@ function createWriteStream(path, options) {
   return new WriteStream(path, options);
 }
 
+const lazyGlob = getLazy(() => require('internal/fs/glob').Glob);
+
+function globSync(pattern, options) {
+  emitExperimentalWarning('globSync');
+  let patterns;
+  if (typeof pattern === 'object') {
+    validateStringArray(pattern, 'patterns');
+    patterns = pattern;
+  } else {
+    validateString(pattern, 'patterns');
+    patterns = [pattern];
+  }
+  const Glob = lazyGlob();
+  return new Glob(patterns, options).globSync();
+}
+
 module.exports = fs = {
   appendFile,
   appendFileSync,
@@ -3135,6 +3154,7 @@ module.exports = fs = {
   ftruncateSync,
   futimes,
   futimesSync,
+  globSync,
   lchown,
   lchownSync,
   lchmod: constants.O_SYMLINK !== undefined ? lchmod : undefined,