Skip to content

Interface: Dirent<Name> ​

A representation of a directory entry, which can be a file or a subdirectory within the directory, as returned by reading from an fs.Dir. The directory entry is a combination of the file name and file type pairs.

Additionally, when readdir or readdirSync is called with the withFileTypes option set to true, the resulting array is filled with fs.Dirent objects, rather than strings or Buffer s.

Since ​

v10.10.0

Extended by ​

Type Parameters ​

Type ParameterDefault type
Name extends string | Bufferstring

Properties ​

PropertyTypeDescription
nameNameThe file name that this fs.Dirent object refers to. The type of this value is determined by the options.encoding passed to readdir or readdirSync. Since v10.10.0
parentPathstringThe path to the parent directory of the file this fs.Dirent object refers to. Since v20.12.0, v18.20.0

Methods ​

isBlockDevice() ​

ts
isBlockDevice(): boolean;

Returns true if the fs.Dirent object describes a block device.

Returns ​

boolean

Since ​

v10.10.0


isCharacterDevice() ​

ts
isCharacterDevice(): boolean;

Returns true if the fs.Dirent object describes a character device.

Returns ​

boolean

Since ​

v10.10.0


isDirectory() ​

ts
isDirectory(): boolean;

Returns true if the fs.Dirent object describes a file system directory.

Returns ​

boolean

Since ​

v10.10.0


isFIFO() ​

ts
isFIFO(): boolean;

Returns true if the fs.Dirent object describes a first-in-first-out (FIFO) pipe.

Returns ​

boolean

Since ​

v10.10.0


isFile() ​

ts
isFile(): boolean;

Returns true if the fs.Dirent object describes a regular file.

Returns ​

boolean

Since ​

v10.10.0


isSocket() ​

ts
isSocket(): boolean;

Returns true if the fs.Dirent object describes a socket.

Returns ​

boolean

Since ​

v10.10.0


ts
isSymbolicLink(): boolean;

Returns true if the fs.Dirent object describes a symbolic link.

Returns ​

boolean

Since ​

v10.10.0