Thefs.promises.glob method in memfs was incorrectly returningPromise<string[]> instead of the Node.js standardAsyncIterableIterator<string>. This made it incompatible with the native Node.js API and prevented users from using the standardfor await...of iteration pattern.

What was wrong

// Before: Incorrect return typefs.promises.glob:(pattern: string,options?:IGlobOptions)=>Promise<string[]>// Usage required awaiting the entire result setconstfiles=awaitfs.promises.glob('*.js');files.forEach(file=>console.log(file));

What's fixed

// After: Correct return type with proper overloadsfs.promises.glob:{(pattern:string|readonlystring[]):AsyncIterableIterator<string>;(pattern:string|readonlystring[],options:IGlobOptions&{withFileTypes:true}):AsyncIterableIterator<IDirent>;(pattern:string|readonlystring[],options:IGlobOptions&{withFileTypes?:false}):AsyncIterableIterator<string>;(pattern:string|readonlystring[],options?:IGlobOptions):AsyncIterableIterator<IDirent|string>;}// Usage now matches Node.js exactlyforawait(constfileoffs.promises.glob('*.js')){console.log(file);}// Supports withFileTypes optionforawait(constdirentoffs.promises.glob('*.js',{withFileTypes:true})){console.log(dirent.name,dirent.isFile());}// Supports multiple patternsforawait(constfileoffs.promises.glob(['*.js','*.ts'])){console.log(file);}

Implementation

• CreatedGlobAsyncIterator: A custom AsyncIterator implementation that yields glob results incrementally
• Added proper method overloads: Supporting all Node.js glob API variants includingwithFileTypes and multiple patterns
• Maintained backward compatibility: Existing functionality works unchanged, just accessed via iteration
• Enhanced test coverage: Added tests forwithFileTypes option and multiple pattern support

The fix ensures memfs now perfectly matches the Node.jsfs.promises.glob API, enabling seamless migration between real and in-memory file systems.

Fixes#1161.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn moreCopilot coding agent tips in the docs.