Function readdir

readdir(path: PathLike, options: BufferEncoding | { encoding: BufferEncoding; withFileTypes?: false }, callback: ((err: SystemError, 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.

Since
v0.0.67
Parameters
- path: PathLike
- options: BufferEncoding | { encoding: BufferEncoding; withFileTypes?: false }
- callback: ((err: SystemError, files: string[]) => void)
  - - (err: SystemError, files: string[]): void
    - Parameters
      
      err: SystemError
      
      files: string[]
      
      Returns void
Returns void
readdir(path: PathLike, options: "buffer" | { encoding: "buffer"; withFileTypes?: false }, callback: ((err: SystemError, files: "buffer".Buffer[]) => void)): void
Asynchronous readdir(3) - read a directory.
Parameters
- path: PathLike
  
  A path to a file. If a URL is provided, it must use the file: protocol.
- options: "buffer" | { encoding: "buffer"; withFileTypes?: false }
  
  The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, 'utf8' is used.
- callback: ((err: SystemError, files: "buffer".Buffer[]) => void)
  - - (err: SystemError, files: "buffer".Buffer[]): void
    - Parameters
      
      err: SystemError
      
      files: "buffer".Buffer[]
      
      Returns void
Returns void
readdir(path: PathLike, options: BufferEncoding | "fs".ObjectEncodingOptions & { withFileTypes?: false }, callback: ((err: SystemError, files: string[] | "buffer".Buffer[]) => void)): void
Asynchronous readdir(3) - read a directory.
Parameters
- path: PathLike
  
  A path to a file. If a URL is provided, it must use the file: protocol.
- options: BufferEncoding | "fs".ObjectEncodingOptions & { withFileTypes?: false }
  
  The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, 'utf8' is used.
- callback: ((err: SystemError, files: string[] | "buffer".Buffer[]) => void)
  - - (err: SystemError, files: string[] | "buffer".Buffer[]): void
    - Parameters
      
      err: SystemError
      
      files: string[] | "buffer".Buffer[]
      
      Returns void
Returns void
readdir(path: PathLike, callback: ((err: SystemError, files: string[]) => void)): void
Asynchronous readdir(3) - read a directory.
Parameters
- path: PathLike
  
  A path to a file. If a URL is provided, it must use the file: protocol.
- callback: ((err: SystemError, files: string[]) => void)
  - - (err: SystemError, files: string[]): void
    - Parameters
      
      err: SystemError
      
      files: string[]
      
      Returns void
Returns void
readdir(path: PathLike, options: "fs".ObjectEncodingOptions & { withFileTypes: true }, callback: ((err: SystemError, files: "fs".Dirent[]) => void)): void
Asynchronous readdir(3) - read a directory.
Parameters
- path: PathLike
  
  A path to a file. If a URL is provided, it must use the file: protocol.
- options: "fs".ObjectEncodingOptions & { withFileTypes: true }
  
  If called with withFileTypes: true the result data will be an array of Dirent.
- callback: ((err: SystemError, files: "fs".Dirent[]) => void)
  - - (err: SystemError, files: "fs".Dirent[]): void
    - Parameters
      
      err: SystemError
      
      files: "fs".Dirent[]
      
      Returns void
Returns void
readdir(path: PathLike, options: BufferEncoding | { encoding: BufferEncoding; withFileTypes?: false }, callback: ((err: SystemError, 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.

Since
v0.0.67
Parameters
- path: PathLike
- options: BufferEncoding | { encoding: BufferEncoding; withFileTypes?: false }
- callback: ((err: SystemError, files: string[]) => void)
  - - (err: SystemError, files: string[]): void
    - Parameters
      
      err: SystemError
      
      files: string[]
      
      Returns void
Returns void
readdir(path: PathLike, options: "buffer" | { encoding: "buffer"; withFileTypes?: false }, callback: ((err: SystemError, files: "buffer".Buffer[]) => void)): void
Asynchronous readdir(3) - read a directory.
Parameters
- path: PathLike
  
  A path to a file. If a URL is provided, it must use the file: protocol.
- options: "buffer" | { encoding: "buffer"; withFileTypes?: false }
  
  The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, 'utf8' is used.
- callback: ((err: SystemError, files: "buffer".Buffer[]) => void)
  - - (err: SystemError, files: "buffer".Buffer[]): void
    - Parameters
      
      err: SystemError
      
      files: "buffer".Buffer[]
      
      Returns void
Returns void
readdir(path: PathLike, options: BufferEncoding | "fs".ObjectEncodingOptions & { withFileTypes?: false }, callback: ((err: SystemError, files: string[] | "buffer".Buffer[]) => void)): void
Asynchronous readdir(3) - read a directory.
Parameters
- path: PathLike
  
  A path to a file. If a URL is provided, it must use the file: protocol.
- options: BufferEncoding | "fs".ObjectEncodingOptions & { withFileTypes?: false }
  
  The encoding (or an object specifying the encoding), used as the encoding of the result. If not provided, 'utf8' is used.
- callback: ((err: SystemError, files: string[] | "buffer".Buffer[]) => void)
  - - (err: SystemError, files: string[] | "buffer".Buffer[]): void
    - Parameters
      
      err: SystemError
      
      files: string[] | "buffer".Buffer[]
      
      Returns void
Returns void
readdir(path: PathLike, callback: ((err: SystemError, files: string[]) => void)): void
Asynchronous readdir(3) - read a directory.
Parameters
- path: PathLike
  
  A path to a file. If a URL is provided, it must use the file: protocol.
- callback: ((err: SystemError, files: string[]) => void)
  - - (err: SystemError, files: string[]): void
    - Parameters
      
      err: SystemError
      
      files: string[]
      
      Returns void
Returns void
readdir(path: PathLike, options: "fs".ObjectEncodingOptions & { withFileTypes: true }, callback: ((err: SystemError, files: "fs".Dirent[]) => void)): void
Asynchronous readdir(3) - read a directory.
Parameters
- path: PathLike
  
  A path to a file. If a URL is provided, it must use the file: protocol.
- options: "fs".ObjectEncodingOptions & { withFileTypes: true }
  
  If called with withFileTypes: true the result data will be an array of Dirent.
- callback: ((err: SystemError, files: "fs".Dirent[]) => void)
  - - (err: SystemError, files: "fs".Dirent[]): void
    - Parameters
      
      err: SystemError
      
      files: "fs".Dirent[]
      
      Returns void
Returns void

Function readdir

Since

Parameters

path: PathLike

options: BufferEncoding | { encoding: BufferEncoding; withFileTypes?: false }

callback: ((err: SystemError, files: string[]) => void)

Parameters

err: SystemError

files: string[]

Returns void

Returns void

Parameters

path: PathLike

options: "buffer" | { encoding: "buffer"; withFileTypes?: false }

callback: ((err: SystemError, files: "buffer".Buffer[]) => void)

Parameters

err: SystemError

files: "buffer".Buffer[]

Returns void

Returns void

Parameters

path: PathLike

options: BufferEncoding | "fs".ObjectEncodingOptions & { withFileTypes?: false }

callback: ((err: SystemError, files: string[] | "buffer".Buffer[]) => void)

Parameters

err: SystemError

files: string[] | "buffer".Buffer[]

Returns void

Returns void

Parameters

path: PathLike

callback: ((err: SystemError, files: string[]) => void)

Parameters

err: SystemError

files: string[]

Returns void

Returns void

Parameters

path: PathLike

options: "fs".ObjectEncodingOptions & { withFileTypes: true }

callback: ((err: SystemError, files: "fs".Dirent[]) => void)

Parameters

err: SystemError

files: "fs".Dirent[]

Returns void

Returns void

Since

Parameters

path: PathLike

options: BufferEncoding | { encoding: BufferEncoding; withFileTypes?: false }

callback: ((err: SystemError, files: string[]) => void)

Parameters

err: SystemError

files: string[]

Returns void

Returns void

Parameters

path: PathLike

options: "buffer" | { encoding: "buffer"; withFileTypes?: false }

callback: ((err: SystemError, files: "buffer".Buffer[]) => void)

Parameters

err: SystemError

files: "buffer".Buffer[]

Returns void

Returns void

Parameters

path: PathLike

options: BufferEncoding | "fs".ObjectEncodingOptions & { withFileTypes?: false }

callback: ((err: SystemError, files: string[] | "buffer".Buffer[]) => void)

Parameters

err: SystemError

files: string[] | "buffer".Buffer[]

Returns void

Returns void

Parameters

path: PathLike

callback: ((err: SystemError, files: string[]) => void)

Parameters

err: SystemError

files: string[]