FileSystemEntry: remove() 方法

已弃用:此特性不再推荐。虽然某些浏览器可能仍然支持它,但它可能已经从相关的网络标准中删除,可能正在删除过程中,或者可能仅为兼容性目的而保留。请避免使用它,如果可能,请更新现有代码;请参阅本页底部的兼容性表格以指导您的决策。请注意,此特性可能随时停止工作。

非标准:此特性未标准化。我们不建议在生产环境中使用非标准特性,因为它们浏览器支持有限,并且可能会更改或被移除。但是,在没有标准选项的特定情况下,它们可以是合适的替代方案。

FileSystemEntry 接口的 remove() 方法会从文件系统中删除文件或目录。目录在删除前必须是空的。

要递归删除目录及其所有内容和子目录,请改用调用 FileSystemDirectoryEntry.removeRecursively()

语法

js
remove(successCallback)
remove(successCallback, errorCallback)

参数

successCallback

文件被成功删除后调用的函数。

errorCallback 可选

如果尝试删除文件失败,则调用此可选回调。

返回值

无(undefined)。

异常

DOMException.INVALID_MODIFICATION_ERR

指定的条目是文件系统的根目录,或者指定的条目是未清空的目录。

DOMException.INVALID_STATE_ERR

文件系统的缓存状态与磁盘上的状态不一致,因此出于安全原因无法删除文件。

DOMException.NO_MODIFICATION_ALLOWED_ERR

文件系统的状态不允许删除文件或目录。

DOMException.NOT_FOUND_ERR

文件或目录不存在。

DOMException.SECURITY_ERR

由于权限或其他访问限制,或者由于对文件资源进行了过多调用,因此无法删除该条目。

示例

此示例删除一个临时工作文件。

js
workingDirectory.getFile(
  "tmp/work-file.json",
  {},
  (fileEntry) => {
    fileEntry.remove(() => {
      /* the file was removed successfully */
    });
  },
  handleError,
);

浏览器兼容性

另见