FileSystemEntry: remove() 方法

已弃用:此功能不再推荐。虽然一些浏览器可能仍然支持它,但它可能已被从相关的 Web 标准中删除,可能正在被删除,或者可能只保留用于兼容性目的。避免使用它,如果可能,请更新现有代码;请参阅此页面底部的兼容性表 来指导您的决定。请注意,此功能可能随时停止工作。

非标准:此功能是非标准的,也不在标准化轨道上。请勿在面向 Web 的生产网站上使用它:它不会对每个用户都起作用。实现之间也可能存在很大差异,并且行为在将来可能会改变。

FileSystemEntry 接口的方法remove() 从文件系统中删除文件或目录。目录必须为空才能删除。

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

语法

js
remove(successCallback)
remove(successCallback, errorCallback)

参数

successCallback

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

errorCallback 可选

删除文件尝试失败时调用的可选回调函数。

返回值

无 (undefined).

异常

FileError.INVALID_MODIFICATION_ERR

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

FileError.INVALID_STATE_ERR

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

FileError.NO_MODIFICATION_ALLOWED_ERR

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

FileError.NOT_FOUND_ERR

文件或目录不存在。

FileError.SECURITY_ERR

由于权限或其他访问限制,或者因为对文件资源的调用过多,导致无法删除条目。

示例

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

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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅