FileSystemFileEntry

File System API の FileSystemFileEntry インターフェイスは、ファイルシステム内のファイルを表します。
このファイルには、ファイルの属性と、ファイルを読むために使用可能な File オブジェクトを作成する file() メソッドも含まれます。

プロパティ

親インターフェイス FileSystemEntry のプロパティを継承しますが、このインターフェイスに固有のプロパティはありません。

メソッド

file()

ファイルの読み込みに使用できる新しい FileWriter オブジェクトを作成します。

廃止されたメソッド

createWriter()

新しい FileWriter オブジェクトを作成し、ファイルシステムエントリで表されるファイルに書き込むことができます。

基本のコンセプト

コンテンツをファイルに書き込むには、createWriter() を呼び出して FileWriter オブジェクトを作成します。 ファイルを読み込むには、file() を呼び出すことによってその内容を表す File オブジェクトを取得します。

例

次のコードは "log.txt" という名前の空のファイルを (存在しない場合は) 作成し、テキスト "Meow" で埋めます。success コールバックの内部では、イベントハンドラは error イベントと writeend イベントを処理するように設定されています。 テキストデータは、blobを作成し、それにテキストを追加し、blobを FileWriter.write() に渡すことによってファイルに書き込まれます。

function onInitFs(fs) {
  fs.root.getFile('log.txt', {create: true}, function(fileEntry) {

    // Create a FileWriter object for our FileSystemFileEntry (log.txt).
    fileEntry.createWriter(function(fileWriter) {
      fileWriter.onwriteend = function(e) {
        console.log('Write completed.');
      };

      fileWriter.onerror = function(e) {
        console.log('Write failed: ' + e.toString());
      };

      // Create a new Blob and write it to log.txt.
      var bb = new BlobBuilder();
      bb.append('Meow');
      
      fileWriter.write(bb.getBlob('text/plain'));
    }, errorHandler);

  }, errorHandler);

}

window.requestFileSystem(window.TEMPORARY, 1024*1024, onInitFs, errorHandler);

仕様

この API には、公式の W3C または WHATWG 仕様はありません。

ブラウザの互換性

あわせて参照

• File and Directory Entries API
• Introduction to the File System API