FileSystemEntry: remove() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("File and Directory Entries API")}}{{Non-standard_Header}}
The {{domxref("FileSystemEntry")}} interface's method **remove()** deletes the file or directory from the file system. Directories must be empty before they can be removed.
To recursively remove a directory as well as all of its contents and its subdirectories, call {{domxref("FileSystemDirectoryEntry.removeRecursively()")}} instead.
Syntax
js-nolint
remove(successCallback)
remove(successCallback, errorCallback)Parameters
successCallback- : A function which is called once the file has been successfully removed.
errorCallback{{optional_inline}}- : An optional callback which is called if the attempt to remove the file fails.
Return value
None ({{jsxref("undefined")}}).
Exceptions
DOMException.INVALID_MODIFICATION_ERR- : The specified entry was the file system's root directory, or the specified entry is
a directory which isn't empty.
DOMException.INVALID_STATE_ERR- : The file system's cached state is inconsistent with its state on disk, so the file
could not be deleted for safety reasons.
DOMException.NO_MODIFICATION_ALLOWED_ERR- : The file system's state doesn't permit removing the file or directory.
DOMException.NOT_FOUND_ERR- : The file or directory doesn't exist.
DOMException.SECURITY_ERR- : The entry couldn't be removed due to permissions or other access constraints, or
because there are too many calls being made on file resources.
Examples
This example deletes a temporary work file.
js
workingDirectory.getFile(
"tmp/work-file.json",
{},
(fileEntry) => {
fileEntry.remove(() => {
/* the file was removed successfully */
});
},
handleError,
);Browser compatibility
{{Compat}}
See also
- File and Directory Entries API
- {{domxref("FileSystemDirectoryEntry.removeRecursively()")}}