Usage in Deno
import { readdirSync } from "node:fs";
readdirSync(path: PathLike,options?: { encoding: BufferEncoding | null; withFileTypes?: false | undefined; recursive?: boolean | undefined; }
| BufferEncoding
| null,): string[]
Reads the contents of the directory.
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 returned. If the encoding
is set to 'buffer'
,
the filenames returned will be passed as Buffer
objects.
If options.withFileTypes
is set to true
, the result will contain fs.Dirent
objects.
path: PathLike
string[]
readdirSync(path: PathLike,options: { encoding: "buffer"; withFileTypes?: false | undefined; recursive?: boolean | undefined; } | "buffer",): Buffer[]
Synchronous readdir(3) - read a directory.
path: PathLike
A path to a file. If a URL is provided, it must use the file:
protocol.
Buffer[]
readdirSync(path: PathLike,options?: (ObjectEncodingOptions & { withFileTypes?: false | undefined; recursive?: boolean | undefined; })
| BufferEncoding
| null,): string[] | Buffer[]
Synchronous readdir(3) - read a directory.
path: PathLike
A path to a file. If a URL is provided, it must use the file:
protocol.
options: (ObjectEncodingOptions & { withFileTypes?: false | undefined; recursive?: boolean | undefined; })
| BufferEncoding
| null
The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, 'utf8'
is used.
string[] | Buffer[]
readdirSync(path: PathLike,options: ObjectEncodingOptions & { withFileTypes: true; recursive?: boolean | undefined; },): Dirent[]
Synchronous readdir(3) - read a directory.
path: PathLike
A path to a file. If a URL is provided, it must use the file:
protocol.
options: ObjectEncodingOptions & { withFileTypes: true; recursive?: boolean | undefined; }
If called with withFileTypes: true
the result data will be an array of Dirent.
Dirent[]