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,
);

瀏覽器相容性

另見