FileSystemWritableFileStream

Baseline 2025

インスタンスプロパティ

親の WritableStream からプロパティを継承します。

インスタンスメソッド

親の WritableStream からメソッドを継承します。

FileSystemWritableFileStream.write: メソッドが呼ばれたファイルの現在のファイルカーソルオフセットにデータを書き込みます。
FileSystemWritableFileStream.seek: 現在のファイルカーソルオフセットを指定の位置 (バイト単位) に移動します。
FileSystemWritableFileStream.truncate: ストリームに対応するファイルのサイズを指定のバイト数にします。

例

この非同期関数は「Save File」ピッカーを開き、このピッカーはファイルが選択されると FileSystemFileHandle を返します。そして、FileSystemFileHandle.createWritable() メソッドを用いて、このハンドルから書き込み可能なストリームを作成します。

その後、ユーザーが指定した Blob をストリームに書き込み、ストリームを閉じます。

async function saveFile() {
  // 新しいハンドルを作成する
  const newHandle = await window.showSaveFilePicker();

  // 書き込み先の FileSystemWritableFileStream を作成する
  const writableStream = await newHandle.createWritable();

  // ファイルに書き込む
  await writableStream.write(imgBlob);

  // ファイルを閉じ、データをディスクに書き込む
  await writableStream.close();
}

以下では、write() メソッドに渡すことができる異なるオプションの例を示しています。

// データだけを渡す (オプションなし)
writableStream.write(data);

// ストリームに指定の位置からデータを書き込む
writableStream.write({ type: "write", position, data });

// 現在のファイルカーソルオフセットを指定の位置に移動する
writableStream.write({ type: "seek", position });

// ファイルを size バイトにする
writableStream.write({ type: "truncate", size });