FileSystemDirectoryHandle.removeEntry()

The removeEntry() method of the FileSystemDirectoryHandle interface attempts to remove an entry if the directory handle contains a file or directory called the name specified.

name

A USVString representing the FileSystemHandle.name of the entry you wish to remove.

options Optional

An optional object containing options, which are as follows:

• recursive: A Boolean. Default false. When set to true entries will be removed recursively.

A Promise which resolves with undefined.

TypeError DOMException

Thrown if the name is not a valid string or contains characters not allowed on the file system

NotAllowedError DOMException

Thrown if PermissionStatus is not 'granted'.

InvalidModificationError DOMException

Thrown if recursive is set to false and the entry to be removed has children.

NotFoundError DOMException

Thrown if an entry name is not found or matched

The following example removes an entry within the directory handle.

const entryName = 'entryToRemove';

// assuming we have a directory handle: 'currentDirHandle'
currentDirHandle.removeEntry(entryName).then( () => {
  // code to run if removing was successful
} );

• File System Access API
• The File System Access API: simplifying access to local files