Oxipng でブラウザー内の PNG を最適化
ブラウザー側で PNG を最適化すると、画像を先にサーバーへ送信せずにアップロードサイズを削減できます。このガイドでは、WebAssembly 経由で Oxipng を実行する
@jsquash/oxipng を使用します。Oxipng は OptiPNG とは別の最適化ツールです。過去から使われているページ URL には以前の名前が残っています。
Oxipng の概要
Oxipng は、デコード後のピクセルを変更せずに PNG の圧縮と表現を書き換えます。見えない RGB 値の変更でもピクセルの厳密な一致が失われるため、透明ピクセルの最適化は無効にします。ファイルのメタデータやバイナリ表現は変わる場合があります。ピクセルがロスレスでも、ファイルがバイト単位で一致するとは限りません。
専用の Worker 内で、このパッケージのバージョンを固定したシングルスレッドコーデックを使用します。UI の応答性を保ち、キャンセル時にはその Worker を終了します。これにより、クロスオリジン分離や入れ子のワーカープールが不要になります。
実装
新しい空のプロジェクトディレクトリを使用します。この構成は Linux 上で
Node.js 24.15.0 と同梱の npm 11.12.1、および Node.js 26.8.1 と npm 12.0.2 を使ってテストしました。これらはテスト済みのバージョンであり、以降のメンテナンス対象の Node.js 24.x リリースも使用できます。ファイルを保存する前に、node --version と
npm --version を確認してください。
以下の四つのファイルをすべてそのディレクトリに保存します。package.json の内容は次のとおりです。
{
"name": "browser-png-optimizer",
"private": true,
"type": "module",
"scripts": { "dev": "vite", "build": "vite build", "preview": "vite preview" },
"dependencies": { "@jsquash/oxipng": "2.3.0" },
"devDependencies": { "vite": "7.3.6" }
}
index.html の内容は次のとおりです。
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>PNG optimizer</title>
</head>
<body>
<h1>PNG optimizer</h1>
<label for="file">PNG file</label>
<input id="file" type="file" accept="image/png">
<button id="cancel" type="button" disabled>Cancel</button>
<p id="status" role="status">Ready.</p>
<a id="download" hidden>Download PNG</a>
<script type="module" src="/main.js"></script>
</body>
</html>
main.js では、一つのジョブが一つの Worker と一つのダウンロード URL を所有します。ファイルを選択するとジョブが開始します。画像データはアップロードされません。
const input = document.getElementById('file')
const cancel = document.getElementById('cancel')
const status = document.getElementById('status')
const download = document.getElementById('download')
let worker
let timer
let job = 0
let downloadUrl
function release() {
worker?.terminate()
worker = undefined
clearTimeout(timer)
input.value = ''
input.disabled = false
cancel.disabled = true
}
function clearDownload() {
if (downloadUrl) URL.revokeObjectURL(downloadUrl)
downloadUrl = undefined
download.hidden = true
download.removeAttribute('href')
}
cancel.addEventListener('click', () => {
job += 1
release()
status.textContent = 'Canceled.'
})
input.addEventListener('change', async () => {
const file = input.files?.[0]
if (!file) return
const current = ++job
release()
clearDownload()
if (file.size === 0 || file.size > 8 * 1024 * 1024) {
status.textContent = 'Choose a PNG no larger than 8 MiB.'
return
}
input.disabled = true
cancel.disabled = false
status.textContent = 'Optimizing PNG.'
const fail = (message) => {
if (current !== job) return
job += 1
release()
status.textContent = message
}
timer = setTimeout(() => fail('Optimization timed out.'), 30_000)
try {
const bytes = await file.arrayBuffer()
if (current !== job) return
worker = new Worker(new URL('./worker.js', import.meta.url), { type: 'module' })
worker.addEventListener('error', () => fail('PNG optimization failed.'))
worker.addEventListener('messageerror', () => fail('PNG optimization failed.'))
worker.addEventListener('message', ({ data }) => {
if (current !== job) return
if (!data.ok) return fail('Choose a valid, non-animated PNG within the image limits.')
const result = new Blob([data.bytes], { type: 'image/png' })
const output = result.size < file.size ? result : file
downloadUrl = URL.createObjectURL(output)
download.href = downloadUrl
download.download = 'optimized.png'
download.hidden = false
status.textContent = result.size < file.size
? 'Optimized PNG is ready.'
: 'The original PNG is already as small or smaller.'
release()
})
worker.postMessage(bytes, [bytes])
} catch {
fail('PNG optimization failed.')
}
})
window.addEventListener('pagehide', () => {
job += 1
release()
clearDownload()
})
Web Workers によるパフォーマンス改善
worker.js では、実際の PNG 最適化処理を呼び出す前にメモリ割り当ての上限を確認します。ヘッダーとチャンクのチェックは予防措置であり、コーデックによる検証の代わりにはなりません。ピクセル数の上限を単一画像に対するものにするため、アニメーション PNG は拒否します。
import init, { optimise } from '@jsquash/oxipng/codec/pkg/squoosh_oxipng.js'
import wasmUrl from '@jsquash/oxipng/codec/pkg/squoosh_oxipng_bg.wasm?url'
function validatePng(buffer) {
const data = new Uint8Array(buffer)
const signature = [137, 80, 78, 71, 13, 10, 26, 10]
if (data.length < 33 || data.length > 8 * 1024 * 1024 ||
!signature.every((byte, i) => data[i] === byte)) throw new Error('Invalid PNG.')
const view = new DataView(buffer)
if (view.getUint32(8) !== 13 || view.getUint32(12) !== 0x49484452) {
throw new Error('Missing PNG header.')
}
const width = view.getUint32(16)
const height = view.getUint32(20)
if (width === 0 || height === 0 || width > 4096 || height > 4096 ||
width * height > 4_000_000) throw new Error('Image exceeds pixel limit.')
let offset = 8
while (offset + 12 <= data.length) {
const length = view.getUint32(offset)
const type = view.getUint32(offset + 4)
if (length > data.length - offset - 12 || type === 0x6163544c) {
throw new Error('Invalid or animated PNG.')
}
offset += length + 12
if (type === 0x49454e44) {
if (length !== 0 || offset !== data.length) throw new Error('Invalid PNG ending.')
return
}
}
throw new Error('Truncated PNG.')
}
self.addEventListener('message', async ({ data }) => {
try {
if (!(data instanceof ArrayBuffer)) throw new Error('Invalid input.')
validatePng(data)
const response = await fetch(wasmUrl)
if (!response.ok) throw new Error('WASM unavailable.')
await init(await response.arrayBuffer())
const bytes = optimise(new Uint8Array(data), 2, false, false)
self.postMessage({ ok: true, bytes: bytes.buffer }, [bytes.buffer])
} catch {
self.postMessage({ ok: false })
}
})
低レベルの optimise 呼び出しでは、レベル 2 を渡し、インターレースを無効にして、透明部分の RGB 値を変更せずに保持します。接尾辞 ?url は
Vite のアセットインポートです。Vite はアプリケーションとともに WASM ファイルを出力します。コーデックのパスはこのパッケージバージョンに固定されているため、アップグレード時には確認してください。高レベル API とマルチスレッドのオプションについては、jSquash のパッケージドキュメントを参照してください。
ブラウザー互換性
プロジェクトディレクトリで、バージョンを固定したパッケージをインストールし、アプリを起動します。
npm install && npm run dev
生成された package-lock.json は保持してください。インストールが失敗した場合は、報告された依存関係またはネットワークのエラーを修正し、同じディレクトリでこのコマンドを再実行してください。保存済みのソースファイルはそのまま残ります。モジュール Worker、WebAssembly、File/Blob API、オブジェクト URL に対応したブラウザーで、Vite が表示するローカル URL を開きます。一連のワークフローは Linux 上の Chromium 145 でテストしました。ほかのブラウザーエンジンやモバイル端末では、別途確認が必要です。
PNG fileでファイルを選択します。ステータスが Optimized PNG is ready. に変わります。Download PNGをクリックして
optimized.png を保存します。最適化候補が元のファイルより小さくない場合は、The original PNG is already as small or smaller.
と表示されます。その場合、ダウンロードには元のバイト列が含まれます。
Ctrl+C で開発サーバーを停止します。ビルドを行い、本番用アセットでも同じファイル入力とダウンロードの流れをテストします。
npm run build && npm run preview
Vite が表示するプレビュー URL を開き、確認が終わったら Ctrl+C でそのサーバーを停止します。Vite preview は確認用にローカルのビルドを配信します。デプロイには静的ホスティングを使用してください。
アプリを開くと JS が取得され、最初のジョブでは WASM アセットも取得されます。画像はローカルに留まりますが、これらのアプリケーションアセットの取得ではネットワーク通信が発生します。
パフォーマンス上の考慮事項
このサンプルの入力上限は 8 MiB、4 百万ピクセル、各辺 4096 ピクセルです。一度に一つのジョブを実行し、30 秒経過時またはキャンセル時に処理を終了します。これらはアプリケーションの制限であり、ブラウザーのピークメモリ使用量を保証するものではありません。モバイル端末では控えめな設定から始めてください。
圧縮レベル 2 により、このサンプルの処理負荷を適度に抑えています。レベルを上げても、十分なサイズ削減が得られず、時間だけが長くなる場合があります。生成ファイルのほうが大きい場合は、元のファイルをダウンロードします。
キャンセルと再試行
処理が完了する前に Cancelをクリックします。Worker が終了し、ステータスが Canceled. に変わります。同じファイルをもう一度選択することも、別のファイルを選択することもできます。ジョブを開始すると前のダウンロードは削除されます。キャンセルされたジョブや失敗したジョブには、ダウンロードできる結果がありません。
空のファイルや 8 MiB を超えるファイルは即座に拒否されます。Worker はコーデックを読み込む前に、不正なヘッダー、アニメーション PNG、寸法またはピクセル数の上限を超える画像を拒否します。残りの PNG データはコーデックが検証します。30 秒経過すると、停止したままのジョブは終了し、ステータスに Optimization timed out.と表示されます。ファイルを再選択して再試行できます。
有効とわかっている PNG で失敗する場合は、ブラウザーのネットワークパネルで
.wasm アセットへのリクエストが成功しているか確認してください。アセットが見つからない場合も、コーデックのエラーと同様にダウンロードは生成されません。バージョンを固定したパッケージから再ビルドし、プレビューを再度テストしてください。このサンプルでは画像はローカルに留まりますが、後でアップロードを受け取るサーバーでも、ファイルの検証は必要です。
より多くの形式をサーバー側で処理するには、Transloadit の画像処理サービスをご覧ください。
