All posts

JavaScript の canvas でアップロード画像のサムネイルを作る

通販サイトの制作で、本人確認書類の画像をアップロードする機能を作っています。アップロードした画像を一覧で確認できるように、サムネイルを用意することにしました。

画像処理というと、サーバー側でサムネイルを生成する方法が思い浮かびます。ただ、そのためだけに画像処理用のモジュールや、大きな画像を扱うためのメモリを考慮する必要があります。複数の処理が重なった場合の負荷も気になるところです。

今回は、ブラウザ上で JavaScript の canvas を使い、小さなサムネイルを生成する方法を試しました。

canvas でサムネイルを生成する

次の関数は、File オブジェクトを受け取り、24×24ピクセルの JPEG サムネイルを Data URL として返します。

// 処理に失敗したときに表示する画像の Data URL
const imgIcon = 'data:image/jpeg;base64,...'

const makeThumbnail = (file) => {
  return new Promise((resolve) => {
    try {
      const canvas = document.createElement('canvas')
      canvas.width = 24
      canvas.height = 24

      const ctx = canvas.getContext('2d')

      if (!ctx) {
        resolve(imgIcon)
        return
      }

      const reader = new FileReader()

      reader.onerror = () => {
        resolve(imgIcon)
      }

      reader.onabort = () => {
        resolve(imgIcon)
      }

      reader.onload = () => {
        const img = new Image()

        img.onerror = () => {
          resolve(imgIcon)
        }

        img.onload = () => {
          try {
            ctx.drawImage(img, 0, 0, 24, 24)
            resolve(canvas.toDataURL('image/jpeg', 0.5))
          } catch (err) {
            resolve(imgIcon)
          }
        }

        img.src = reader.result
      }

      reader.readAsDataURL(file)
    } catch (err) {
      resolve(imgIcon)
    }
  })
}

imgIcon には、読み込みや画像の生成に失敗したときに表示する、デフォルト画像の Data URL を指定します。上の ... の部分は実際の画像データに置き換えてください。

処理の流れは次のとおりです。

  1. 24×24ピクセルの canvas を作成する
  2. FileReader でファイルを Data URL として読み込む
  3. Image オブジェクトに画像を読み込ませる
  4. canvas に画像を描画する
  5. canvas.toDataURL() で JPEG の Data URL を取得する

toDataURL('image/jpeg', 0.5) の 0.5 は JPEG の画質を指定しています。戻り値は、data:image/jpeg;base64, で始まる文字列です。[MDN の toDataURL() リファレンス]

サムネイルの使い方

makeThumbnail() は Promise を返すので、async / await や then() で結果を受け取れます。

const thumbnail = await makeThumbnail(file)

// 例:img 要素に表示する
document.querySelector('#thumbnail').src = thumbnail

今回は、どのような画像かが大まかに分かれば十分なので、縦横比を維持せず、24×24ピクセルの正方形に描画しています。縦長や横長の画像は変形するため、見た目が必要な場合は drawImage() の描画範囲を調整します。

また、読み込める画像形式はブラウザの対応状況によって異なります。ブラウザで読み込めない画像は、デフォルトのサムネイルになります。

サーバーに保存するとき

今回は、アカウントのテーブルにサムネイル用のフィールドを作り、生成した Data URL を文字列のまま保存することを考えています。JSON でも扱いやすく、小さな画像を一覧で表示する用途には便利です。

ただし、小さな画像でも本人確認書類から生成したデータです。データベースに保存した場合も、閲覧できるユーザーを制限し、不要になったデータを削除できるようにしておきたいところです。

ブラウザ側でサムネイルを作れば、サーバー側でサムネイル生成の処理を用意せずに済みます。サムネイルだけを送信する用途であれば通信量も抑えられますが、本人確認のために元画像もアップロードする場合は、元画像の通信量が発生します。

Discussion