JSZipでメモをZIPにまとめる:静的Webページで2〜3ファイルを作る実験

プログラミング・Web開発カテゴリを表すパンダのイラスト プログラミング・Web開発

この記事について
この記事は、生成AIを活用した自動生成フローで作成しています。JSZipの公式情報を参照し、ブラウザー内で短い架空のメモからZIPを作る静的教材を用意しました。

検証ステータス:🧪 入力処理のテスト済み・ブラウザーでのZIP生成は未確認
Node.jsで固定ファイル名・入力制限など9件のロジックテストを確認しました。GitHub Pagesの到達、実際のZIP生成・ダウンロード・展開はまだ確認していません。

JSZipでメモをZIPにまとめる:静的Webページで2〜3ファイルを作る実験

複数のテキストを1つのZIPにまとめたいとき、必ずサーバーへアップロードする必要があるのでしょうか。短い文章を扱うだけなら、ブラウザー内でZIPを生成する方法があります。JavaScriptライブラリのJSZipを利用すれば、ZIPの内部構造や圧縮処理を一から実装しなくても、ファイル名と内容を指定してまとめられます。

今回の教材は、単にZIPを出力するボタンを作るだけではありません。ファイルを作る処理・利用者のダウンロード操作・保存したあとの管理が別の工程であることを体験するためのものです。既存のファイルは読まず、架空のメモだけを使います。

まず操作する:ライブデモ

デモ画面が開いたら、初期値として用意された架空のメモを確認し、「ZIPを作成」を押してください。作成されるZIPには、説明用のREADME.txtと入力を格納したmemo.txtが入る設計です。これが最初の2ファイルです。

次に「チェックリスト.txtも含める」を選び、もう一度ボタンを押します。checklist.txtを加えた3ファイルになることが期待結果です。画面には、含まれるファイル名とZIPのサイズ(バイト数)を表示します。実際にダウンロードするときは、別に表示される「ZIPをダウンロード」のリンクをクリックします。

この順序を区別してください。ZIP生成の完了は端末への保存完了ではありません。 保存先は利用者のブラウザー設定にも左右されます。生成しただけで「パソコンへ保存しました」と表示する設計にはしていません。

実験の条件

項目内容
利用ライブラリJSZip v3.10.2
配信構成HTML・CSS・JavaScriptをGitHub Pagesから静的配信
実行時の外部CDN不要。ライブラリをvendor/に同梱
入力200文字以内の架空のテキスト
ZIPの中身README.txt、memo.txt、任意でchecklist.txt
既存ファイルの読み取りしない
外部API・データベース使わない
実行確認入力検査・ファイル名のロジック9件。ZIPバイナリ生成は未確認

「静的サイト」といっても、表示が変わらないという意味ではありません。サーバーから配信されるファイルが静的でも、ブラウザーがJavaScriptを実行してZIPの内容やサイズを動的に変えられます。今回のデモを開くためのネットワーク通信と、ボタンを押したあとのZIP生成処理も別です。

JSZipは何を担当するのか

ZIPへ内容を追加するにはzip.file(name, content)を使います。これによってZIPの中へ入れるファイルを登録できます。Windowsのエクスプローラーなどへ直接ファイルを書き込む命令ではありません。

const zip = new JSZip();
zip.file("README.txt", "架空の説明文\\n");
zip.file("memo.txt", "架空の作業メモ\\n");

const blob = await zip.generateAsync({
  type: "blob",
  compression: "DEFLATE"
});

generateAsync()はZIP全体の生成を開始し、非同期で結果を返します。type: "blob"は、ブラウザーで扱いやすいBlob形式で受け取る指定です。compression: "DEFLATE"で圧縮形式を指定しています。ライブラリの処理は非同期なので、完成する前に保存用リンクを有効にしないことが重要です。

なお、同じファイルを2つまとめたからサイズが2倍になるわけではありません。ZIPにはヘッダーなどの管理情報が含まれますし、テキストが重複しているほど圧縮されやすい場合もあります。圧縮後のサイズは入力した内容によって変わるため、記事中で特定のバイト数を実測値として断定しません。

Blobと一時的なダウンロードURL

ZIPのBlobができたら、URL.createObjectURL(blob)でブラウザー内の一時URLを作り、リンクのhrefに割り当てます。リンクのdownload属性には、教材用の固定名daily-code-demo.zipを指定します。

もう一度ZIPを生成した場合、以前の一時URLを残したままにしないよう、URL.revokeObjectURL()で解放します。ページを離れる際にも解放を試みるコードを入れています。ただし、利用ブラウザーやOSにおけるメモリー解放の詳細は今回の実機では未検証です。

もしブラウザーで「生成は成功したのにファイルが見つからない」というときは、まずダウンロードリンクをクリックしたか、保存先がどこに設定されているかを確認します。ZIPが生成できたかという問題と、端末に保存できたかという問題を混同しないことが大切です。

ファイル名を固定する理由

今回、利用者はメモの文章を変更できますが、ZIPに含めるファイル名は自由入力にしていません。固定のREADME.txtとmemo.txt、追加する場合のchecklist.txtの3種類だけです。これは、教材の動きの説明を簡単にするだけでなく、不要なファイル名・パスの扱いを避けるためでもあります。

たとえば入力欄に../secret.txtと書いても、その文字列はmemo.txtの中の文章になり、ZIP内部のパス名には使いません。ZIPの名前を入力から直接組み立てる場合には、パス区切り、絶対パス、意図しないフォルダーへの展開など別の危険を考慮しなければなりません。

さらに、教材の入力処理は文字列以外を拒否し、200文字を超えた場合もエラーを返します。画面にはmaxlengthもありますが、それだけに頼らずロジックでも確認しています。画面上の入力制限とプログラム内部の境界検査は別です。将来別のボタンや呼び出し元が増えても、ロジックの前提が分かりやすくなります。

1条件だけ変更して観察する

最初はチェックボックスをOFFにしたままZIPを作り、次にONへ変更してください。中に入るファイル名は2件から3件へ変わります。これは追加したchecklist.txtの分です。一方、メモの長さを増やす比較では、ファイル件数は変わらず、内容と圧縮後のサイズが変化します。

この違いは実務のエクスポート機能を作るときにも重要です。ファイル数が増えたのか、それぞれの中身が大きくなったのか、利用者が選択したオプションが増えたのかを別々に確認できるようにします。複数条件を同時に変えてしまうと、どの要因でZIPの内容が変わったのか分からなくなります。

なお、今回のテストが確認したのは「2/3件となるファイル名のリスト」「境界値」「空文字」「文字列以外の拒否」「絵文字を含む200文字の扱い」などです。ZIPバイナリを実際にブラウザーで生成して展開したことの証明ではありません。

動かない場合の切り分け

観測した問題確認点対処
ページが開かないGitHub Pagesの公開設定・URLREADMEからHTMLとファイル配置を確認
生成ボタンが使えないvendor/jszip.min.jsを読み込めたか配布ファイルの相対パスを確認
入力が拒否される200文字を超えていないか架空の短文へ戻して試す
ダウンロードリンクがないZIP生成が成功しているか表示メッセージとConsoleを確認
ダウンロードしたものが見つからない保存先・ブラウザーの確認画面ブラウザーのダウンロード履歴を確認
ZIPが大きく感じる入力文・追加ファイル・圧縮形式同じ短文で比較して原因を絞る

ローカルのHTMLをfile://で開くと、JavaScriptモジュールがCORS制限で読み込まれない場合があります。教材READMEの手順に従い、静的HTTPサーバーから開いてください。新しいデータベースや本番PHPサーバーを追加する必要はありません。

業務へ取り入れる前の注意

JSZipは便利ですが、ZIPの暗号化やマルウェア検査、送信先の権限管理まで自動的に保証するものではありません。今回のデモは短いダミー文字列をまとめるだけです。実在する顧客名や契約内容を入力しないでください。機密ファイルをZIPにしただけで安全に共有できると判断するのも避けます。

業務で使うなら、出力対象の許可リスト、サイズ上限、文字コード、ファイル名の正規化、作成後の読戻し、保存先のアクセス権を検討します。大容量ファイルをブラウザー内で一括生成すれば、メモリー使用量や処理時間の問題もあります。今回の200文字という小さな実験を、巨大なバックアップ生成へそのまま拡張できるとは考えないでください。

また、生成したZIPに含まれるテキストは、受け取った人が解凍して読むことができます。ライブラリがZIP形式のファイルを生成できることと、秘密情報を保護できることは別です。安全なファイル共有には、送受信の保護とアクセス管理を別途設計する必要があります。

まとめ

JSZipを同梱すれば、静的Webページでも複数のテキストをまとめるZIP生成機能を構成できます。まず2件で作り、チェックボックスだけを変えて3件にしてみてください。ファイルを登録する、ZIPを生成する、保存操作へ進むという役割の違いがつかめれば、ライブラリの利用方法を理解しやすくなります。

公式資料とサンプル

検証と未確認

Node.js v22.16.0で、GitHub教材とGit blob SHAが一致する入力関数・テストを実行し、9件すべて合格しました。版固定のJSZip v3.10.2とライセンスファイルも配布元のGit blob SHAとの一致を確認しました。GitHub Pagesの到達、ZIPバイナリの実生成・保存・展開、実際のブラウザー画面、WordPress上の表示は未確認です。

文書情報

記事タイトル
JSZipでメモをZIPにまとめる:静的Webページで2〜3ファイルを作る実験
作成日
更新日
Source URL
https://papanda925.com/?p=18676

ライセンス: 本記事のうち、当サイトが権利を有する本文・自作図表は、特記なき限り CC BY 4.0 で利用できます。生成AIを活用して作成・編集した内容を含みます。コードについて、別途ライセンス表示またはリンク先GitHubリポジトリのライセンスがある場合は、その条件を優先します。引用・第三者資料・画像・商標等は本ライセンスの対象外です。 利用ポリシー

タイトルとURLをコピーしました