小さな出力なら Blob と object URL は便利だ。しかしファイルが大きくなると、応答、Blob、通常のアプリ状態が同時に保持され、低メモリ端末から問題が出る。reader に替えても、全チャンクを配列にためれば使用量は減らない。
JavaScript による変換が必要か、対象環境で保存先を選んで書けるか、失敗をどう伝えるかを先に決める。通常のダウンロード応答をブラウザーに任せる方法が最も簡単なことも多い。
変換不要なら通常のダウンロードを検討する
認可されたリンクと応答なら、ファイル全体を JavaScript のオブジェクトにせずに済む。クロスオリジン、名前、認証情報の挙動は実環境で確認し、download 属性だけを信用しない。署名 URL も期限と範囲を制限し、解析ログに残さない。
検査や変換の必要がある場合だけバイト列を引き受ける。書き込み能力がなければ、サーバーダウンロードや非同期ジョブへ戻す。無制限の Blob はストリームと同じメモリ特性ではない。
利用者の操作中に保存先を選ぶ
File System Access の選択器には実行条件とユーザー操作の要件がある。対応を確認し、長い通信の前にクリック処理から選択する。通信後では操作の有効期間が切れる場合がある。選択のキャンセルと通信失敗も分けて表示する。
例は選択器を注入してテストできるようにし、完全応答だけを扱う。Range 再開は含まない。管道は Streams、書き込みは File System の資料を参照する。
export async function saveResponse(url, chooseFile, signal, onBytes = () => {}) {
const handle = await chooseFile();
const writable = await handle.createWritable();
try {
const response = await fetch(url, { signal });
if (response.status !== 200 || !response.body) {
throw new Error(`download rejected: ${response.status}`);
}
let received = 0;
const meter = new TransformStream({
transform(chunk, controller) {
received += chunk.byteLength;
onBytes(received);
controller.enqueue(chunk);
},
});
await response.body.pipeThrough(meter).pipeTo(writable, { signal });
return received;
} catch (error) {
try { await writable.abort(error); } catch { /* preserve original error */ }
throw error;
}
}
// Invoke directly from a click handler in a supported secure context:
// saveResponse(url, () => window.showSaveFilePicker(), signal, renderBytes);
pipeTo が完了してから保存済みにする。失敗時は書き込み中止を試み、元のエラーを保持する。中止後の実際のファイルは環境で検証し、どんな場合も一時内容が残らないと約束しない。finally で常に close すると部分結果を成功に見せてしまう。
進捗は同じ層のバイトを比較する
例は受信量だけを知らせる。Content-Length はないこともあり、圧縮された転送量と JavaScript が読む展開後の量が違う場合もある。安定した総量が必要ならサーバーが明示する。分母がなければ不確定の進捗にし、百パーセントを超える表示を作らない。
受信、変換、保存を区別する。通信が終わってもファイルの終了で失敗し得る。変換器の内部キューも制限し、コールバックが全データを保持する実装を避ける。背圧は管道の参加者間の調整であり、任意の保存を防ぐ仕組みではない。
再開には同じリソースである保証が要る
Range を使うなら、版、状態、範囲、総量を確認し、サーバーが範囲を無視して 200 を返す場合も処理する。単純に末尾へ加えると別版同士を結合してしまう。暗号化や圧縮では、位置がどの表現を指すかも必要だ。
回復可能な出力は、サーバーが固定したオブジェクトを作り、ジョブ ID、版、検証情報を返す構成が扱いやすい。seek があるだけでは通信の再開契約を省略できない。
メモリと失敗後の結果を検証する
大きな応答と遅い書き込み先を使い、全サイズに比例してメモリが増えないことを確認する。開始前と途中のキャンセル、書き込み失敗、本文欠落、エラー応答も試す。端末、サイズ、観測した最大使用量を記録し、未計測の削減率を書かない。
対応環境と代替方法を明記し、保存結果を再度開くか検証する。進捗の終点だけでは、利用者が完全なファイルを得たことを証明できない。
