FileSystemDirectoryHandle: removeEntry() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{securecontext_header}}{{APIRef("File System API")}}{{AvailableInWorkers}}
The **removeEntry()** method of the {{domxref("FileSystemDirectoryHandle")}} interface attempts to remove an entry if the directory handle contains a file or directory called the name specified.
Syntax
js-nolint
removeEntry(name)
removeEntry(name, options)Parameters
name- : A string representing the {{domxref('FileSystemHandle.name')}} of
the entry you wish to remove.
options{{optional_inline}}- : An optional object containing options, which are as follows:
recursive{{optional_inline}}- : A boolean value, which defaults to
false. When set totrueentries will be removed recursively.
Return value
A {{jsxref('Promise')}} which resolves with undefined.
Exceptions
- {{jsxref("TypeError")}}
- : Thrown if the name is not a valid string or contains characters not allowed on the file system.
NotAllowedError{{domxref("DOMException")}}- : Thrown if the {{domxref('PermissionStatus.state')}} for the handle is not
'granted'inreadwritemode. InvalidModificationError{{domxref("DOMException")}}- : Thrown if
recursiveis set to false and the entry to be removed has children. NotFoundError{{domxref("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
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- File System API
- The File System Access API: simplifying access to local files