Node fs.readdir function | API Reference | Bun
BuildDocsReferenceGuidesBlogDiscord/
node:fs/
readdirNreaddir
Search the reference...
/
BuildDocsReferenceGuidesBlogDiscord/
node:fs/
readdirNreaddir
namespace
fs.readdirfunction
readdir(path:
PathLike,options: undefined | null | BufferEncoding | { encoding: unknown; recursive: boolean; withFileTypes: false },callback: (err: null | ErrnoException, files: string[]) => void): void;
Reads the contents of a directory. The callback gets two arguments (err, files) where files is an array of the names of the files in the directory excluding '.' and '..'.
See the POSIX readdir(3) documentation for more details.
The optional options argument can be a string specifying an encoding, or an object with an encoding property specifying the character encoding to use for the filenames passed to the callback. If the encoding is set to 'buffer', the filenames returned will be passed as Buffer objects.
If options.withFileTypes is set to true, the files array will contain fs.Dirent objects.
function
readdir(path:
PathLike,options: 'buffer' | { encoding: 'buffer'; recursive: boolean; withFileTypes: false },callback: (err: null | ErrnoException, files: NonSharedBuffer[]) => void): void;
Asynchronous readdir(3) - read a directory.
@param path
A path to a file. If a URL is provided, it must use the file: protocol.
@param options
The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, 'utf8' is used.
function
readdir(path:
PathLike,options: undefined | null | BufferEncoding |
ObjectEncodingOptions & { recursive: boolean; withFileTypes: false },callback: (err: null | ErrnoException, files: string[] | NonSharedBuffer[]) => void): void;
Asynchronous readdir(3) - read a directory.
@param path
A path to a file. If a URL is provided, it must use the file: protocol.
@param options
The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, 'utf8' is used.
function
readdir(path:
PathLike,callback: (err: null | ErrnoException, files: string[]) => void): void;
Asynchronous readdir(3) - read a directory.
@param path
A path to a file. If a URL is provided, it must use the file: protocol.
function
readdir(path:
PathLike,options:
ObjectEncodingOptions & { recursive: boolean; withFileTypes: true },callback: (err: null | ErrnoException, files:
Direntstring>[]) => void): void;
Asynchronous readdir(3) - read a directory.
@param path
A path to a file. If a URL is provided, it must use the file: protocol.
@param options
If called with withFileTypes: true the result data will be an array of Dirent.
function
readdir(path:
PathLike,options: { encoding: 'buffer'; recursive: boolean; withFileTypes: true },callback: (err: null | ErrnoException, files:
DirentNonSharedBuffer>[]) => void): void;
Asynchronous readdir(3) - read a directory.
@param path
A path to a file. If a URL is provided, it must use the file: protocol.
@param options
Must include withFileTypes: true and encoding: 'buffer'.
namespace
readdirResources
ReferenceDocsGuidesDiscordMerch StoreGitHubBlog Toolkit
RuntimePackage managerTest runnerBundlerPackage runnerProject
Bun 1.0Bun 1.1Bun 1.2Bun 1.3RoadmapContributingLicenseBaked with ❤️ in San Francisco
We're hiring →