FileSystemDirectoryHandle: removeEntry() method

Baseline 2023
Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

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

Note: This feature is available in Web Workers.

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

js
removeEntry(name)
removeEntry(name, options)

Parameters

name

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

options Optional

An optional object containing options, which are as follows:

recursive Optional

A boolean value, which defaults to false. When set to true entries will be removed recursively.

Return value

A Promise which resolves with undefined.

Exceptions

TypeError

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

NotAllowedError DOMException

Thrown if the PermissionStatus.state for the handle is not 'granted' in readwrite mode.

InvalidModificationError DOMException

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

NotFoundError DOMException

Thrown if the current entry is not found or if the entry of the specific name is not found or matched.

Examples

The following example removes an entry within the directory handle.

js
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
# api-filesystemdirectoryhandle-removeentry

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
removeEntry

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

See also