FileSystemDirectoryHandle: getDirectoryHandle() method

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The getDirectoryHandle() method of the FileSystemDirectoryHandle interface returns a FileSystemDirectoryHandle for a subdirectory with the specified name within the directory handle on which the method is called.

Syntax

js

getDirectoryHandle(name)
getDirectoryHandle(name, options)

Parameters

name

A string representing the FileSystemHandle.name of the subdirectory you wish to retrieve.

options Optional

An optional object containing options for the retrieved subdirectory. Options are as follows:

create

A boolean value, which defaults to false. When set to true if the directory is not found, one with the specified name will be created and returned.

Return value

A Promise which resolves with a FileSystemDirectoryHandle.

Exceptions

NotAllowedError DOMException

Thrown if PermissionStatus is not 'granted'.

TypeMismatchError DOMException

Thrown if the returned entry is a file and not a directory.

NotFoundError DOMException

Thrown if directory doesn't exist and the create option is set to false.

Examples

The following example returns a directory handle with the specified name, if the directory does not exist it is created.

js

const dirName = "directoryToGetName";

// assuming we have a directory handle: 'currentDirHandle'
const subDir = currentDirHandle.getDirectoryHandle(dirName, { create: true });

Specifications

Specification
File System Standard
# api-filesystemdirectoryhandle-getdirectoryhandle

Browser compatibility

BCD tables only load in the browser

See also