FileWriter

作為物件，它允許您創建和向檔中寫入資料。

屬性

  • readyState： 三種可能狀態之一，或者 INIT ， WRITING ，或DONE.

  • 檔案名: 要寫入的檔的名稱。() DOMString

  • 長度： 要寫入的檔的長度。(長)

  • 位置： 當前檔指標的位置。(長)

  • 錯誤： 包含錯誤的物件。() FileError

  • onwritestart： 當寫操作開始時調用。（函數）

  • onwrite： 當請求已成功完成時調用。（函數）

  • onabort： 當寫操作已中止時調用。例如，通過調用 abort () 方法。（函數）

  • onerror： 當寫操作已失敗時調用。（函數）

  • onwriteend： 當請求已完成 （無論成功或失敗） 時調用。（函數）

下面的屬性不受支援：

  • onprogress： 寫入檔，報告進度的角度時稱為 progress.loaded / progress.total 。（函數）

方法

  • 中止: 中止寫入檔。

  • 尋求： 將檔指標移到指定的位元組。

  • 截斷： 縮短至指定長度的檔。

  • 寫： 將資料寫入到該檔。

詳細資訊

FileWriter物件提供 utf-8 編碼檔寫入設備檔案系統的方法。 應用程式回應 writestart ， progress ， write ， writeend ， error ，和 abort 的事件。

每個 FileWriter 對應于一個檔中，資料可以被寫入許多倍。 FileWriter維護的檔 position 和 length 屬性，允許到 app seek 和 write 檔中的任意位置。 預設情況下， FileWriter 將寫入到檔中，覆蓋現有資料的開始。 設置可選的 append 到布林 true 在 FileWriter 的建構函式來寫入到檔的末尾。

下面列出的所有平臺都支援文本資料。 正在寫入到檔案系統之前文本編碼為 utf-8。 一些平臺還支援可以作為 ArrayBuffer 或 Blob 傳遞中的二進位資料。

支援的平臺

文本和二進位的支援：

  • Android 系統
  • iOS

僅限文本的支援：

  • 黑莓手機 WebWorks （OS 5.0 和更高）
  • Windows Phone 7 和 8
  • Windows 8

尋求快速的示例

function win(writer) {
    // fast forwards file pointer to end of file
    writer.seek(writer.length);
};

var fail = function(evt) {
    console.log(error.code);
};

entry.createWriter(win, fail);

截斷快速示例

function win(writer) {
    writer.truncate(10);
};

var fail = function(evt) {
    console.log(error.code);
};

entry.createWriter(win, fail);

寫快速示例

function win(writer) {
    writer.onwrite = function(evt) {
        console.log("write success");
    };
    writer.write("some sample text");
};

var fail = function(evt) {
    console.log(error.code);
};

entry.createWriter(win, fail);

二進位檔案寫入快速示例

function win(writer) {
    var data = new ArrayBuffer(5),
        dataView = new Int8Array(data);
    for (i=0; i < 5; i++) {
        dataView[i] = i;
    }
    writer.onwrite = function(evt) {
        console.log("write success");
    };
    writer.write(data);
};

var fail = function(evt) {
    console.log(error.code);
};

entry.createWriter(win, fail);

追加快速示例

function win(writer) {
    writer.onwrite = function(evt) {
    console.log("write success");
};
writer.seek(writer.length);
    writer.write("appended text");
};

var fail = function(evt) {
    console.log(error.code);
};

entry.createWriter(win, fail);

中止快速示例

function win(writer) {
    writer.onwrite = function(evt) {
        console.log("write success");
    };
    writer.write("some sample text");
    writer.abort();
};

var fail = function(evt) {
    console.log(error.code);
};

entry.createWriter(win, fail);

完整的示例

<!DOCTYPE html>
<html>
  <head>
    <title>FileWriter Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        window.requestFileSystem(LocalFileSystem.PERSISTENT, 0, gotFS, fail);
    }

    function gotFS(fileSystem) {
        fileSystem.root.getFile("readme.txt", {create: true, exclusive: false}, gotFileEntry, fail);
    }

    function gotFileEntry(fileEntry) {
        fileEntry.createWriter(gotFileWriter, fail);
    }

    function gotFileWriter(writer) {
        writer.onwriteend = function(evt) {
            console.log("contents of file now 'some sample text'");
            writer.truncate(11);
            writer.onwriteend = function(evt) {
                console.log("contents of file now 'some sample'");
                writer.seek(4);
                writer.write(" different text");
                writer.onwriteend = function(evt){
                    console.log("contents of file now 'some different text'");
                }
            };
        };
        writer.write("some sample text");
    }

    function fail(error) {
        console.log(error.code);
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>Write File</p>
  </body>
</html>