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 を指定します。上の ... の部分は実際の画像データに置き換えてください。
処理の流れは次のとおりです。
- 24×24ピクセルの
canvasを作成する FileReaderでファイルを Data URL として読み込むImageオブジェクトに画像を読み込ませるcanvasに画像を描画する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