FileSystemDirectoryHandle.removeEntry()

Draft

This page is not complete.

Secure context

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

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.

Syntax

FileSystemDirectoryHandle.removeEntry(name).then...

Parameters

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.

Return value

A Promise which resolves with undefined.

Exceptions

TypeError
If the name is not a valid string or contains characters not allowed on the file system
NotAllowedError
If PermissionStatus is not 'granted'.
InvalidModificationError
If recursive is set to false and the entry to be removed has children.
NotFoundError
If an entry name is not found or matched

Examples

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
} );

Specifications

Specification
File System Access
# api-filesystemdirectoryhandle-removeentry

Browser compatibility

BCD tables only load in the browser

See also