Node.js での PNG 最適化ツールの比較
デコード後のピクセルを変えたくない場合は、OptiPNG または Sharp のフルカラー PNG を選びます。色の正確さを多少犠牲にしてサイズを減らせる場合は、pngquant または Sharp のパレット出力を試します。このガイドでは、同じ入力に対して全4構成を実行し、サイズ、経過時間、ピクセルの差を記録します。手元の画像で比較し、適切な構成を選べます。
ツールの概要
Pngquant
pngquant は、透明度を含めて最大256色のパレットに画像を変換します。品質範囲の設定によっては、変換が拒否されることがあります。パレット PNG でも PNG の可逆圧縮を使いますが、色の選択によって元のピクセルが変わる場合があります。
Optipng
OptiPNG は圧縮設定を探索し、デコード後の画像を変えずにビット深度やカラータイプを削減できます。ここでは -o7 を使い、より低いレベルよりも多くの圧縮の組み合わせを試します。すでに十分小さい画像は、最適化しても変わらない場合があります。
Sharp
Sharp の PNG オプション は、フルカラー出力とパレット出力に対応しています。compressionLevel は量子化せずに圧縮の処理量を制御し、adaptiveFiltering は行フィルタリングを有効にします。quality または effort を設定するとパレットが有効になるため、フルカラーでの比較では両方とも省略します。Sharp の品質80と pngquant の
65-80 は、異なるエンコーダーの設定値であり、同等の実測品質を表すものではありません。
インストール
Bash、Node.js 24 または 26 LTS の最新パッチ、Yarn 4.12.0 を使う Corepack、および PATH 上の OptiPNG 7.9.1 を使用します。このサンプル全体は、2026年11月6日に Linux 上で Node.js 24.22.2 および 26.13.0 と
Corepack 0.34.5 を使ってテストしました。他のプラットフォームでは、ネイティブバイナリーや処理時間が異なる場合があります。
Node.js 26 では、Corepack を別途インストールします。Node.js 25 以降には同梱されていません。OptiPNG は公式ダウンロードページからインストールします。このサンプルでは npm ラッパーではなく、その実行ファイルを呼び出します。以下で固定するパッケージバージョンは、記載した日付の比較に合わせています。
png-compare がまだ存在しないディレクトリから、新しいプロジェクトを作成します。
(
mkdir png-compare &&
cd png-compare &&
printf '{"private":true,"type":"module","packageManager":"yarn@4.12.0"}\n' > package.json &&
touch yarn.lock &&
YARN_IGNORE_PATH=1 YARN_ENABLE_GLOBAL_CACHE=false YARN_ENABLE_SCRIPTS=true \
YARN_NODE_LINKER=node-modules corepack yarn add --exact sharp@0.35.3 pngquant-bin@9.0.0 pngjs@7.0.0
)
サブシェルを使うため現在のディレクトリは変わらず、&& により、途中の処理が失敗するとセットアップが停止します。空のロックファイルにより、別のワークスペース内でも独立した Yarn プロジェクトになります。環境設定では、継承された yarnPath を無視し、ローカルの依存関係をインストールして、pngquant のネイティブインストールを有効にします。依存関係の解決を再現できるよう、生成されたロックファイルは保存してください。残りのコマンドは png-compare から実行します。
以下のプログラムは、拡張子を .mts にして保存します。Node はコンパイラーや継承された設定なしで .mts ファイルを ES モジュールとして実行します。継承された tsconfig.json も不要です。pngjs は、検証に使う独立した PNG デコーダーを提供します。
単一の PNG の比較
次のコードを compare.mts として保存します。静止画の8ビット RGB または RGBA PNG を使います。このスクリプトは、アニメーション、16ビット入力、および ICC、sRGB、ガンマ、色度、Exif のチャンクを拒否します。検証では保存されたサンプル値とアルファ値を比較しますが、カラーマネジメント適用後の見た目やメタデータの保持を確認するものではありません。元の画像は保存してください。
import { execFile } from 'node:child_process'
import { createHash } from 'node:crypto'
import { mkdir, readFile, writeFile } from 'node:fs/promises'
import { join, resolve } from 'node:path'
import { promisify } from 'node:util'
import { PNG } from 'pngjs'
import pngquant from 'pngquant-bin'
import sharp from 'sharp'
const execFilePromise = promisify(execFile)
type Pixels = { width: number; height: number; data: Uint8Array }
function decodePng(bytes: Buffer): Pixels {
const image = PNG.sync.read(bytes, { checkCRC: true })
// Hidden RGB is not rendered, and decoders represent tRNS keys differently.
for (let index = 0; index < image.data.length; index += 4) {
if (image.data[index + 3] === 0) image.data.fill(0, index, index + 3)
}
return image
}
function checkInput(bytes: Buffer): void {
if (bytes[24] !== 8 || ![2, 6].includes(bytes[25])) {
throw new Error('Use an 8-bit RGB or RGBA PNG')
}
for (let offset = 8; offset + 12 <= bytes.length;) {
const length = bytes.readUInt32BE(offset)
const type = bytes.toString('ascii', offset + 4, offset + 8)
if (['acTL', 'iCCP', 'gAMA', 'cHRM', 'sRGB', 'eXIf'].includes(type)) {
throw new Error(`Unsupported input chunk: ${type}; use an unprofiled static PNG`)
}
offset += length + 12
}
}
function pixelMetrics(before: Pixels, after: Pixels) {
if (before.width !== after.width || before.height !== after.height) {
throw new Error('Output dimensions differ from the input')
}
let changedPixels = 0
let squaredError = 0
let maxAlphaError = 0
for (let index = 0; index < before.data.length; index += 4) {
const alphaBefore = before.data[index + 3] / 255
const alphaAfter = after.data[index + 3] / 255
maxAlphaError = Math.max(maxAlphaError, Math.abs(alphaBefore - alphaAfter) * 255)
if (before.data.subarray(index, index + 4).some((value, channel) =>
value !== after.data[index + channel])) changedPixels++
for (const background of [0, 255]) {
for (let channel = 0; channel < 3; channel++) {
const a = before.data[index + channel] * alphaBefore + background * (1 - alphaBefore)
const b = after.data[index + channel] * alphaAfter + background * (1 - alphaAfter)
squaredError += (a - b) ** 2
}
}
}
return {
changedPixels,
rmse: Number(Math.sqrt(squaredError / (before.width * before.height * 6)).toFixed(3)),
maxAlphaError: Math.round(maxAlphaError),
}
}
async function optimizeWithPngquant(input: string, output: string, quality: string) {
try {
await execFilePromise(pngquant, [
`--quality=${quality}`, '--strip', '--speed=3', '--output', output, '--', input,
])
return output
} catch (error) {
if (error instanceof Error && 'code' in error && error.code === 99) return null
throw new Error('pngquant failed', { cause: error })
}
}
async function optimizeWithOptipng(input: string, output: string) {
await execFilePromise('optipng', ['-o7', '-strip', 'all', '-out', output, '--', input])
return output
}
async function optimizeWithSharp(input: string, output: string, palette: boolean) {
await sharp(input)
.png(palette
? { compressionLevel: 9, adaptiveFiltering: true, palette: true, quality: 80, effort: 10 }
: { compressionLevel: 9, adaptiveFiltering: true, palette: false })
.toFile(output)
return output
}
async function main(): Promise<void> {
const [inputArgument, directoryArgument, quality = '65-80', ...extra] = process.argv.slice(2)
const range = /^(\d{1,3})-(\d{1,3})$/.exec(quality)
if (!inputArgument || !directoryArgument || extra.length || !range ||
Number(range[1]) > Number(range[2]) || Number(range[2]) > 100) {
throw new Error('Usage: node compare.mts INPUT.png NEW_DIRECTORY [MIN-MAX]')
}
const input = resolve(inputArgument)
const directory = resolve(directoryArgument)
const original = await readFile(input)
const before = decodePng(original)
checkInput(original)
const versions = {
node: process.version,
sharp: sharp.versions.sharp,
libvips: sharp.versions.vips,
pngquant: (await execFilePromise(pngquant, ['--version'])).stdout.trim(),
optipng: (await execFilePromise('optipng', ['-version'])).stdout.trim().split('\n')[0],
}
await mkdir(directory)
const jobs = [
{ name: 'pngquant', lossless: false, settings: `quality=${quality}, speed=3`, run:
(output: string) => optimizeWithPngquant(input, output, quality) },
{ name: 'optipng', lossless: true, settings: '-o7 -strip all', run:
(output: string) => optimizeWithOptipng(input, output) },
{ name: 'sharp-full', lossless: true, settings: 'compressionLevel=9, adaptiveFiltering=true, palette=false', run:
(output: string) => optimizeWithSharp(input, output, false) },
{ name: 'sharp-palette', lossless: false, settings: 'quality=80, effort=10, compressionLevel=9, adaptiveFiltering=true', run:
(output: string) => optimizeWithSharp(input, output, true) },
]
const results = []
for (const job of jobs) {
const start = performance.now()
const file = await job.run(join(directory, `${job.name}.png`))
const ms = Number((performance.now() - start).toFixed(1))
if (file === null) {
results.push({ name: job.name, status: 'refused', settings: job.settings, ms })
continue
}
const encoded = await readFile(file)
const metrics = pixelMetrics(before, decodePng(encoded))
if (job.lossless && metrics.changedPixels !== 0) {
throw new Error(`${job.name}: decoded pixels changed`)
}
results.push({ name: job.name, status: 'encoded', file, settings: job.settings,
bytes: encoded.length, ms, ...metrics })
}
const report = {
input: { file: input, bytes: original.length, width: before.width, height: before.height,
sha256: createHash('sha256').update(original).digest('hex') },
versions,
results,
}
const reportFile = join(directory, 'results.json')
await writeFile(reportFile, `${JSON.stringify(report, null, 2)}\n`, { flag: 'wx' })
console.table(results)
console.log(`Report: ${reportFile}`)
}
main().catch((error: unknown) => {
console.error(`Comparison failed for ${process.argv[2] ?? '(no input)'}:`,
error instanceof Error ? error.message : error)
process.exitCode = 1
})
結果はすべて新しく作成したディレクトリに保存します。既存のディレクトリは拒否し、その中のファイルを置き換えることはありません。入力が無効な場合や前提条件が満たされない場合は、ディレクトリを作成する前に失敗します。その後のエンコードや検証で失敗すると、不完全な PNG が残る場合がありますが、完成した results.json は残りません。レポートは、コマンドが正常終了した後にのみ使用してください。
pngquant の終了コード99は、候補ファイルを伴わない refused 行になります。これは指定した品質設定で変換が拒否されたことを意味し、元の画像のデコード失敗ではありません。特に、拒否された場合は出力の実測スコアは得られません。他のエラーでは比較処理が失敗します。
changedPixels は、アルファ値がゼロの部分に隠れた RGB を無視したうえで、異なる RGBA ピクセルの数を数えます。可逆圧縮の行ではゼロでなければなりません。rmse は、黒と白の背景に合成した後の RGB 誤差を、0–255のサンプル値スケールで測定します。maxAlphaError は最大のアルファ値の差を示します。これらは有用な検証指標ですが、平均誤差が小さくても、エッジの劣化やバンディングが隠れている場合があります。パレット画像を採用する前に、想定する表示サイズで両方の背景に重ね、目視で確認してください。
ファイルサイズの比較
次のコードを make-fixtures.mts として保存します。滑らかなグラデーション、四色の線画、透明・半透明・不透明のピクセルを含む色付きの帯という、三つの256 × 256 PNG を作成します。入力のエンコードには低い圧縮レベルを使い、比較時に再圧縮の余地を残しています。
import { mkdir, writeFile } from 'node:fs/promises'
import { PNG } from 'pngjs'
async function main(): Promise<void> {
await mkdir('fixtures')
const size = 256
for (const name of ['gradient', 'line-art', 'alpha']) {
const data = Buffer.alloc(size * size * 4)
for (let y = 0; y < size; y++) {
for (let x = 0; x < size; x++) {
const index = (y * size + x) * 4
const line = x % 32 < 2 || y % 32 < 2
const color = x < 128 ? [30, 110, 220] : [230, 70, 40]
const rgb = name === 'gradient' ? [x, y, Math.floor((x + y) / 2)]
: name === 'line-art' ? (line ? [0, 0, 0] : (y < 128 ? color : [255, 255, 255]))
: color
data.set(rgb, index)
data[index + 3] = name === 'alpha' ? (x < 64 ? 0 : x < 192 ? 128 : 255) : 255
}
}
const bytes = PNG.sync.write({ width: size, height: size, data }, { deflateLevel: 1 })
await writeFile(`fixtures/${name}.png`, bytes, { flag: 'wx' })
}
}
main().catch((error: unknown) => {
console.error(error instanceof Error ? error.message : error)
process.exitCode = 1
})
両方のプログラムを保存したら、次を実行します。
node make-fixtures.mts &&
node compare.mts fixtures/gradient.png results-gradient &&
node compare.mts fixtures/line-art.png results-line-art &&
node compare.mts fixtures/alpha.png results-alpha
比較が成功するたびに、表と results.json へのパスが表示され、名前付きの PNG 出力も生成されます。ジェネレーターは、既存の fixtures ディレクトリを拒否します。別の画像や設定を試すには、新しい結果ディレクトリを指定して compare.mts を再利用します。たとえば次のコマンドでは、他の構成は変えずに、pngquant に最も厳しい品質設定を指定します。
node compare.mts fixtures/gradient.png results-strict 100-100
2026年10月3日に Linux x86-64 で実行した一例では、Node.js 24.15.0、pngquant 3.0.3 を提供する pngquant-bin 9.0.0、OptiPNG 7.9.1、Sharp 0.35.3、libvips 8.18.3、pngjs 7.0.0 を使用しました。pngquant は二つの OpenMP スレッドを使用しました。29,234 B のグラデーション入力に対し、プログラム内の設定で次の結果が得られました。
| 構成 | バイト数 | 時間(ms) | 変更ピクセル数 | RMSE |
|---|---|---|---|---|
| pngquant | 18,681 | 32.1 | 65,317 | 6.081 |
| OptiPNG | 679 | 182.6 | 0 | 0 |
| Sharp フルカラー | 830 | 6.2 | 0 | 0 |
| Sharp パレット | 36,104 | 241.3 | 65,314 | 5.164 |
このグラデーションはピクセル値が規則的なため、パレットなしでも効率よく圧縮できます。量子化では色が変化し、可逆圧縮の構成よりファイルが大きくなりました。Sharp のパレット出力は、入力よりも大きくなりました。線画のテスト画像では、すべての構成でデコード後のピクセルが保持され、OptiPNG は195 B、pngquant は198 B になりました。四つの構成すべてで、アルファ値のテスト画像の描画色と、0、128、255のアルファ値も保持されました。これらの小さな合成入力は動作の違いを示すものであり、本番環境の素材群を代表するものではありません。
時間は、各行につきエンコーダーを逐次的に一回呼び出した際のもので、サブプロセスの起動とファイル書き込みを含みます。セットアップと独立したピクセル検証は含みません。これはローカルでの測定値であり、スループットのベンチマークではありません。代表的な素材で繰り返し測定し、バージョンと設定をレポートに記録してください。
適切なツールの選択
図など、ピクセルの完全一致が必要な素材では、OptiPNG と sharp-full を比較し、changedPixels がゼロ以外の結果は採用しないでください。色数が少なければ、パレットでも正確にエンコードできる場合があります。ただし、パレット変換では必ず細部が失われると決めつけず、実際のピクセルを確認してください。グラデーションや半透明のエッジでは、サイズの削減量を誤差の列や目視確認の結果と照らし合わせます。
候補が元の画像より大きい場合、変換が拒否された場合、または見た目が悪化した場合は、元の画像を使います。リサイズなどの処理がすでに同じ Node.js パイプラインに含まれている場合は Sharp を使い、ピクセルが保持されるか検証しながら既存の PNG を再圧縮したい場合は OptiPNG を使います。
