FileSystemFileEntry:createWriter() 方法

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

非標準:此特性未標準化。我們不建議在生產環境中使用非標準特性,因為它們瀏覽器支援有限,並且可能會更改或被移除。但是,在沒有標準選項的特定情況下,它們可以是合適的替代方案。

FileSystemFileEntry 介面的 createWriter() 方法返回一個 FileWriter 物件,該物件可用於將資料寫入由目錄條目表示的檔案。

語法

js
createWriter(successCallback)
createWriter(successCallback, errorCallback)

引數

successCallback

一個回撥函式,在 FileWriter 成功建立時呼叫;FileWriter 作為唯一引數傳遞到回撥函式中。

errorCallback 可選

如果提供了此引數,則它必須是一個在嘗試建立 FileWriter 時發生錯誤時呼叫的方法。此回撥函式接收一個 DOMException 物件作為輸入,該物件描述了錯誤。

返回值

無(undefined)。

示例

此示例建立了一個名為 writeToFileEntry() 的方法,該方法將文字字串輸出到與傳入的目錄條目對應的檔案中。

js
function writeToFileEntry(entry, text) {
  entry.createWriter(
    (fileWriter) => {
      let data = Blob([text], { type: "text/plain" });

      fileWriter.write(data);
    },
    (error) => {
      /* do whatever to handle the error */
    },
  );
}

createWriter() 呼叫的成功回撥函式接收傳入的文字,並建立一個新的 text/plain 型別的 Blob 物件,其中包含傳入的文字。然後,該 blob 被輸出到 FileWriter 物件中,以便寫入檔案。

規範

此功能不再是任何規範的一部分。它已不再有望成為標準。

瀏覽器相容性

另見