JSZip でブラウザー内に ZIP アーカイブを作成
ブラウザーの File オブジェクトを JSZip に渡し、ZIP の Blob を生成して、その Blob をダウンロードリンクに渡します。以下の完全なページでは、複数のローカルファイルを選択またはドロップし、archive.zip としてダウンロードできます。進捗表示と、入力の合計サイズの制限も備えています。
この例では、選択したファイルをアップロードせず、圧縮サーバーも必要ありません。JSZip を CDN から読み込むため、ライブラリの読み込みにはインターネット接続が必要です。圧縮処理とそのメモリ消費はブラウザー内で完結します。ユーザーのデバイス上にすでにある、比較的小規模なファイル群に適した方法です。
ブラウザー用の完全なサンプルの実行
以下を空のフォルダーに新しい index.html として保存し、デスクトップ版 Chrome で開きます。ビルド手順やローカルサーバーは不要です。スクリプトでは JSZip 3.10.2 に固定しています。この例は macOS 上の Chrome 153 でテストしました。
ファイル選択で個々のファイルを選ぶか、fieldset 内にドロップします。選択するたびに以前のファイル群が置き換わり、選択中の名前がファイル選択欄の下に表示されます。フォルダーの再帰的な探索は含まれていません。Create ZIP をクリックし、ダウンロードが要求されるのを待ってから、ブラウザーのダウンロード一覧から ZIP を開きます。
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Create a ZIP with JSZip</title>
</head>
<body>
<h1>Create a ZIP</h1>
<fieldset id="dropZone">
<legend>Choose files or drop them here</legend>
<label for="fileInput">Files to archive</label>
<input type="file" id="fileInput" multiple />
<p id="selection">No files selected.</p>
<button type="button" id="zipButton">Create ZIP</button>
</fieldset>
<p id="progress" role="status">Select files totaling at most 100 MiB.</p>
<script src="https://cdn.jsdelivr.net/npm/jszip@3.10.2/dist/jszip.min.js"></script>
<script>
const fileInput = document.getElementById('fileInput')
const dropZone = document.getElementById('dropZone')
const selection = document.getElementById('selection')
const progress = document.getElementById('progress')
let selectedFiles = []
let busy = false
function selectFiles(files) {
if (busy) return
selectedFiles = Array.from(files)
// The names below remain visible; clearing the picker allows reselection.
fileInput.value = ''
selection.textContent = selectedFiles.length
? `Selected files: ${selectedFiles.map((file) => file.name).join(', ')}`
: 'No files selected.'
progress.textContent = 'Ready to create ZIP.'
}
fileInput.addEventListener('change', () => selectFiles(fileInput.files))
dropZone.addEventListener('dragover', (event) => {
event.preventDefault()
event.dataTransfer.dropEffect = busy ? 'none' : 'copy'
})
dropZone.addEventListener('drop', (event) => {
event.preventDefault()
selectFiles(event.dataTransfer.files)
})
async function createZip() {
if (busy) return
const files = selectedFiles.slice()
if (files.length === 0) {
progress.textContent = 'Select or drop files first.'
return
}
if (typeof JSZip === 'undefined') {
progress.textContent = 'JSZip could not load. Check your connection and reload.'
return
}
const totalSize = files.reduce((sum, file) => sum + file.size, 0)
if (totalSize > 100 * 1024 * 1024) {
progress.textContent = 'Select at most 100 MiB of files.'
return
}
const names = new Set()
for (const file of files) {
if (names.has(file.name)) {
progress.textContent = `Duplicate filename: ${file.name}. Rename it first.`
return
}
names.add(file.name)
}
busy = true
dropZone.disabled = true
progress.textContent = 'Generating ZIP…'
try {
const zip = new JSZip()
for (const file of files) zip.file(file.name, file)
const blob = await zip.generateAsync(
{
type: 'blob',
compression: 'DEFLATE',
compressionOptions: { level: 6 },
},
({ percent }) => {
progress.textContent = `Generating ZIP: ${Math.round(percent)}%`
},
)
const url = URL.createObjectURL(blob)
// Leave time for the browser to consume the URL before releasing it.
setTimeout(() => URL.revokeObjectURL(url), 60_000)
const link = document.createElement('a')
link.href = url
link.download = 'archive.zip'
document.body.appendChild(link)
link.click()
link.remove()
progress.textContent = 'ZIP download requested. Check your browser’s downloads.'
} catch {
progress.textContent = 'Could not create ZIP. Reselect the files and try again.'
} finally {
busy = false
dropZone.disabled = false
}
}
document.getElementById('zipButton').addEventListener('click', createZip)
</script>
</body>
</html>
簡単に確認するには、名前の異なるテキストファイルと画像を選択します。ダウンロードした ZIP のルートに両方のファイルがあり、内容が変わっていないことを確認します。もう一度生成すると、再びダウンロードを要求できます。archive.zip は推奨ファイル名です。保存先や、同名のファイルがすでにある場合の名前変更・置換の確認は、ブラウザーが制御します。ページが強制的に上書きすることはありません。
ファイルの直接追加と生成進捗の表示
ファイル入力とファイルのドロップは、どちらも File API を通じて
File オブジェクトを提供します。JSZip の file(name, data) メソッドは、これらを直接受け取れます。File は Blob の一種だからです。ローカルファイルをアーカイブに追加する際に、別途 FileReader でラップしたり、base64 に変換したりする必要はありません。
generateAsync() は、完成したアーカイブを返す Promise を返します。ここでは Blob を生成し、レベル六の DEFLATE を使用します。コールバックの percent は、ダウンロードではなくアーカイブ生成の進捗を表します。Blob の準備ができると、一時 URL を通じてリンクから利用できるようになります。ダウンロード要求後、タイマーがその URL を解放します。
「ZIP download requested」は、意図的に「保存済み」と区別しています。リンクの download プロパティでは、ダウンロードが実際に行われたかどうかは確認できません。ブラウザーの設定でブロックされたり、保存ダイアログでキャンセルされたりする場合があります。ファイルが見当たらない場合は、ダウンロードパネルを確認してください。
ZIP 生成処理の同時実行を一つに制限
圧縮を開始する前に、busy ガードを設定します。Promise が保留中の間、fieldset はファイル選択とボタンを無効にし、selectFiles() は新たなドロップや変更イベントを無視します。処理では元の選択内容を保持するため、再度クリックしても、別のアーカイブの生成が始まったり、進捗メッセージが置き換わったりしません。成功または失敗の後、finally がコントロールを有効に戻します。選択内容を変えるには、現在の処理が終わるのを待ってから、新しいファイルを選択またはドロップしてください。
JSZip は同じ名前が再度追加されると、既存のエントリを更新します。重複チェックにより、選択したファイルが別の選択済みファイルを通知なく置き換えるのを防ぎます。異なるフォルダーのファイルが同じベース名を持つ場合に重要です。再試行する前に、どちらかの名前を変更してください。大文字と小文字だけが異なる名前も、大文字と小文字を区別しないファイルシステムに展開すると衝突する場合があります。
CDN から読み込めない場合、ページは接続を確認するよう促します。読み取りや圧縮が失敗した場合は、ファイルの再選択を促します。処理が失敗した場合、ダウンロードは要求しません。オフラインで動作させる必要があるページでは、CDN に依存せず、バージョンを固定した JSZip バンドルをページと一緒に配信してください。
大きなファイルの扱いとパフォーマンスの考慮事項
100 MiB のチェックは入力ポリシーの一例であり、ブラウザーの処理容量を保証するものではありません。JSZip の
generateAsync() は結果全体をメモリに保持します。入力の読み取りと圧縮にもメモリが必要です。小さなファイルが多数ある場合も、オーバーヘッドが増えます。対象デバイスがその処理量に余裕をもって対応できない場合は、制限を低く設定してください。
DEFLATE は繰り返しの多いテキストを小さくできますが、圧縮済みの画像や動画では効果がほとんどない場合があります。これらのファイルをまとめるだけなら、JSZip は圧縮を行わない
compression: 'STORE' もサポートしています。圧縮処理を Web Worker に移すと、ページのメインスレッドでの実行を避けられますが、generateAsync({ type: 'blob' }) が結果をディスクにストリーミングするようにはなりません。大規模なエクスポートには、別のメモリ管理・出力戦略が必要です。
ブラウザーの互換性
ここで検証した環境は、macOS 上のデスクトップ版 Chrome です。ほかのブラウザーには、File API、Promise、async/await、Blob URL、およびその URL からのダウンロードへの対応が必要です。ファイルをドラッグできないデバイス向けにファイル選択を残し、サポート対象の各ブラウザーで選択、エラーからの復旧、実際のダウンロードをテストしてください。JSZip ライブラリ自体の対応だけでは、ページ全体のダウンロードフローがそのブラウザーで動作するとは判断できません。
