zip.jsの圧縮、ストリーム、Zip64を使い分ける

ZIPをJavaScriptの入出力へ組み込む

zip.jsは、ZIPファイルの圧縮と展開を行うJavaScriptライブラリです。リポジトリの説明では、並列圧縮、Web Streams、Zip64、分割ファイル、データ暗号化、Deflate64の展開を扱うとされています。ブラウザで生成したファイルをダウンロードさせる処理や、取得したアーカイブからエントリを読む処理を、JavaScriptのReaderとWriterで組み立てるための部品です。

READMEは大量データ向けの設計を掲げていますが、対応するサイズ上限や必要メモリを数値で提示していません。Zip64は4GBを超えるアーカイブを扱うための形式ですが、利用するブラウザ、保存先、利用者の端末によって実際の限界は変わります。機能名だけを見て運用可能と判断せず、入力サイズ、出力先、失敗時に残る一時データを自分の環境で確認するのが先です。分割ZIPやDeflate64も、相手側の解凍ソフトが対応するかを確認し、作成できたことと交換できることを別に判定します。

Hello worldで読む基本API

READMEの最初の例は、Hello worldという文字列をhello.txtというエントリにしてZIPへ追加し、その後に展開する流れです。ZipWriterはBlobWriterへ出力し、TextReaderが文字列を読みます。ライターを閉じて生成したBlobを、BlobReaderとZipReaderで読み直し、最初のエントリをTextWriterへ渡します。

この例で、zip.jsの基本的な責務が分かります。入力を読むReader、出力を作るWriter、ZIPのエントリを管理するZipReaderとZipWriterを組み合わせます。パッケージは@zip.js/zip.jsから読み込み、Denoではjsr:@zip-js/zip-jsを使う注記があります。コードをそのまま本番へ移す前に、空ファイル、Unicodeのファイル名、複数エントリ、途中でReaderが失敗する場合を追加して、結果と例外を記録します。

Web Streamsで大きな処理を流す

二つ目の例は、Web Streams APIを使うHello world with Streamsです。書き込み側ではZipWriterがTransformStreamのwritable側へ書き、readable側をnew Response(readable).blob()でBlobに変換します。読み込み側では、エントリのデータを別のTransformStreamへ流し、new Response(readable).text()で文字列として取り出します。

ストリームを使うと、完成した大きなバッファを一度に手渡す設計から、流れながら処理する設計へ切り替えられます。とはいえ、内部バッファの大きさ、背圧、エラー伝播の扱いはREADMEの例だけでは分かりません。ネットワークから受け取った入力をそのまま圧縮する場合は、通信中断、読み手の速度差、Writerを閉じる前のキャンセルを試します。ブラウザの対応状況も対象環境ごとに確認してください。

複数エントリの並行追加を検証する

三つ目の例は、ZipWriterとBlobWriterに対してPromise.allで二つのエントリを追加します。一つはTextReaderから読み、もう一つはunpkgからREADMEを取得するHttpReaderを使います。両方の追加が終わったらライターを閉じ、生成したBlobをダウンロードリンクへ変換します。

並行追加の例は、入力が文字列だけでなくHTTP取得結果でもよいこと、完了を待ってからアーカイブを閉じることを示します。READMEには、同時に追加できるエントリ数、片方が失敗したときのもう片方の扱い、性能への影響は書かれていません。実装ではPromise.allの失敗後にWriterを閉じられるか、ネットワーク応答を信頼できるか、同名エントリがどう扱われるかを個別に確認します。

デモ、ドキュメント、テストの役割

READMEには、zip-managerのライブデモ、gildas-lormeau.github.io/zip.jsのプロジェクト文書、tests/allにあるテストスイートへのリンクがあります。デモはAPIの感触を得る入口、文書はクラスとオプションを調べる場所、テストは実際の対応範囲を読む場所として分けて使えます。READMEだけでは、テストフレームワーク、カバレッジ、すべてが自動実行されるかまでは確認できません。

メタデータでは、主な言語はJavaScript、既定ブランチはmaster、ライセンスはBSD-3-Clause、open issueは1件です。直近のリリースはv2.8.61で、取得日時点の更新情報です。公開された機能が多くても、使う版を固定し、デモと同じ入力を自分のブラウザで実行し、テストディレクトリの対象を読んでから依存更新の判断をするほうが安全です。

BSD 3-Clauseと導入前の負荷試験

zip.jsはBSD 3-Clauseライセンスで配布され、著作権はGildas Lormeauに帰属します。表示、条件、免責事項を保持する範囲で、ソースやバイナリの利用と再配布が認められます。ソフトウェアは現状のまま提供され、ライセンスはサポート、セキュリティ保証、長期保守を約束しません。

導入対象は、ZIPの作成と展開をWebやJavaScriptの処理へ組み込みたいチームです。最初はBlobとTextReaderで一つのエントリを往復させ、次にTransformStream、HTTP入力、複数エントリ、暗号化、4GBを超える形式の順に試します。各段階で生成物、メモリ使用量、失敗時の後始末、利用するブラウザを保存し、READMEにない性能値を自分たちの基準として明確にしてから本番へ進めます。暗号化を使う場合は、鍵の配布や失効、復号できない場合の利用者向け表示も実装側で決めます。大容量テストではファイルを細かく増やし、処理時間だけでなく画面が固まらないかも観察します。

互換性をファイルの往復で確かめる

ZIPの利用では、作成側と展開側が同じライブラリとは限りません。zip.jsで作った通常のアーカイブを別の解凍ソフトで開き、ファイル名、文字コード、ディレクトリ、タイムスタンプを確認します。逆方向では外部ソフトで作ったアーカイブをZipReaderで読み、空のエントリや大きなファイルで結果を比べます。

暗号化、分割ZIP、Deflate64、Zip64は、対応条件を分けてテストします。エントリが一つ壊れたときに全体を廃棄するのか、読める部分を返すのかは、利用者へ示す必要があります。READMEにない仕様を暗黙に決めず、入力、出力、例外、ブラウザ、zip.jsの版を試験記録へ残してください。

編集部の結論

zip.jsは、JavaScriptからZIPを生成または展開し、BlobやWeb Streamsを既存のWeb処理へつなぎたい開発者に向きます。READMEにはHello world、ストリーム処理、複数エントリの並行追加、Zip64、暗号化など具体的な機能が載っていますが、ストリームの保持量、同時処理数、暗号方式の運用条件は一律に保証していません。まず小さなファイルで入出力を照合し、次に大容量と失敗時の動作を測ってください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes