チェッカーは先頭バイトからファイル形式を判定する

チェッカーは選択されたファイルを開き、先頭バイトを固定のシグネチャセットと比較します。比較処理は apps/web/lib/image/inspect.ts に直接記述されており、JPEG 分岐では if (startsWith(bytes, [0xff, 0xd8, 0xff])) return "jpeg"; となっています。ファイル名はこの比較に含まれておらず、ブラウザが報告するファイルの MIME タイプも含まれていません。

そのため、ファイル名を .jpg に変更しても、別のファイルとして報告されることがあります。BMP に .jpg という名前を付けても、JPEG とはみなされません。ファイル名は変更されていますが、先頭バイトは変更されておらず、先頭バイトは入力データ全体だからです。

このページの帰属情報: apps/web/lib/image/inspect.ts、apps/web/lib/image/evaluate.ts、apps/web/components/tools/etsy-image-checker.tsx、apps/web/components/tools/product-image-resizer.tsx。feat/expansion-wave-01-continuous 作業ツリーの 2026-08-18 を参照してください。

リーダーは、PNG、JPEG、GIF、WebP、HEIC、SVGに一致させることができます。これらはリーダーが認識するシグネチャです。

ファイルの先頭バイトがこれらのシグネチャのいずれにも一致しない場合、不明として報告されます。不明とは、一致しないことを示すものであり、診断結果ではありません。リーダーがフォーマットを特定できなかったことを示し、ファイル内の画像が破損していないかどうかについては何も示しません。

チェッカーは、独自のフォーマットリストを保持しています。apps/web/lib/image/evaluate.tsには、.jpg、.gif、.png、.svg、.heicが受け入れられるフォーマットとして指定され、その後、ファイルが読み込まれたフォーマットが示されます。WebPとして読み込まれたファイルはこのリストに含まれていないため、結果は失敗となります。

ピッカーは別の問題です。ピッカーはすべての画像タイプを受け入れるように設定されているため、WebPファイルがそもそも選択できるのです。選択は受け入れとは異なります。ファイルが読み込まれ、フォーマットが特定され、その後リストが適用されます。 WebP ファイルの場合、結果は毎回失敗となります。

このリストは、このツールが適用するルールであり、ツール自身のコードに記録されています。これは、現在どのマーケットプレイスでもアップロード時に受け入れられる形式を示すものではなく、このページでその疑問を解決するものではありません。

アニメーションと判定されたGIFは、apps/web/lib/image/evaluate.ts に「アニメーションGIFはサポートされていません」というタイトルのエラー結果を生成します。

判定は、ファイル内のグラフィック制御拡張ブロックの数を数えることで行われます。ブロックが1つ以上ある場合、ファイルはアニメーションとして扱われます。コード自体では、このカウントはヒューリスティックであると説明されています。

したがって、販売者にとって重要な方向において、このテストは誤った結果を示す可能性があります。通常とは異なる方法でエンコードされた単一フレームのGIFは、原則としてアニメーションとしてカウントされる可能性があります（inspect.ts:163）。静止画のエクスポートが繰り返しアニメーションとして検出される場合、この検出結果は動いている画像ではなく、ファイルの構造を記述していることになります。