始めるチュートリアル開発者ガイドヘッドレス Chrome を使用して SVG を PNG に変換する

Headless Chrome を使用して SVG を PNG に変換する

Imgix が SVG ファイルのラスタライズをサポートしている にもかかわらず、内部的に SVG ファイルを PNG に変換する必要がある場合があります。

この記事では、Headless Chrome を使用して SVG を PNG に変換する実装例を示します。

これは、foreignObject やカスタムフォントを持つ text 要素など、多くの画像処理ライブラリでサポートされていない要素を含む SVG ファイルをラスタライズする必要がある場合や、特定のフレームのみをキャプチャする必要があるアニメーション付きの SVG ファイルがある場合に便利です。

前提条件

他のクラウドプロバイダーでも同様のソリューションを作成することは可能ですが、この例では AWS サービスを使用します。

  • SVG および PNG ファイルを保存するための S3 バケット
  • AWS Lambda (ランタイム: Node.js 22.x)
  • カスタマイズされた Chromium フォーク
  • Headless Chrome ブラウザを制御するための Puppeteer-core

実装

ステップ 1: Lambda レイヤーを作成する

Chromium バイナリを含む Lambda レイヤーを作成します。

このステップは、デフォルトの Lambda 環境にはサイズ制限があり、Chromium バイナリを直接アップロードできないため必要です。

Lambda 関数のアーキテクチャに合ったビルド済みのレイヤー zip を Sparticuz/chromium のリリースページからダウンロードします。たとえば、x86_64 の関数の場合は次のとおりです。

curl -LO https://github.com/Sparticuz/chromium/releases/download/v153.0.0/chromium-v153.0.0-layer.x64.zip

zip ファイルを S3 バケットにアップロードし、Lambda レイヤーを作成します。

互換性のあるランタイムには Node.js 22.x を選択します。

ステップ 2: Lambda 関数を作成する

以下の設定で新しい Lambda 関数を作成します。

  • ランタイム: Node.js 22.x
  • メモリ: 1024MB (必要に応じて調整)
  • タイムアウト: 5 分 (必要に応じて調整)
  • 前に作成した Lambda レイヤーを追加
  • S3 バケットからの読み取りおよび書き込みの必要な権限を Lambda 関数に付与

ステップ 3: Lambda 関数のコードを作成する

ローカルマシンに以下のプロジェクトを作成します。

    • package.json
    • index.mjs
package.json
{
  "type": "module",
  "dependencies": {
    "@aws-sdk/client-s3": "^3.1152.0",
    "puppeteer-core": "25.11.0"
  },
  "devDependencies": {
    "@sparticuz/chromium": "153.0.0"
  }
}

@sparticuz/chromium は実行時に Lambda レイヤーから提供されるため、開発依存関係として追加します。そのバージョンは、使用する puppeteer-core のバージョンがサポートする Chromium のバージョンと一致している必要があります。どちらかのパッケージをアップグレードする際は、Puppeteer の Chromium サポートページを確認してください。

Warning

簡単なデモンストレーションの目的で、トリガーのsuffixオプションを使用して .svg 拡張子のファイルのみを処理しています。プロダクション環境では、 ファイル拡張子以外のファイルタイプを区別できるより堅牢な方法を 検討することをお勧めします。

index.mjs
import chromium from "@sparticuz/chromium"
import puppeteer from "puppeteer-core"
import { S3Client, GetObjectCommand, PutObjectCommand } from "@aws-sdk/client-s3"
 
const s3 = new S3Client({})
 
export const handler = async (event) => {
  const bucket = event.Records[0].s3.bucket.name
  const key = decodeURIComponent(
    event.Records[0].s3.object.key.replace(/\+/g, " ")
  )
 
  // Download SVG file from S3
  const svgData = await s3.send(new GetObjectCommand({ Bucket: bucket, Key: key }))
  const svg = await svgData.Body.transformToString("utf-8")
 
  let browser = null
 
  try {
    browser = await puppeteer.launch({
      args: await puppeteer.defaultArgs({
        args: chromium.args,
        headless: "shell",
      }),
      executablePath: await chromium.executablePath(),
      headless: "shell",
    })
 
    const page = await browser.newPage()
    await page.setContent(svg)
    await page.waitForSelector("svg")
    const screenshot = await page.screenshot({ type: "png" })
 
    const outputKey = key.replace(".svg", ".png")
    await s3.send(
      new PutObjectCommand({
        Bucket: bucket,
        Key: outputKey,
        Body: screenshot,
        ContentType: "image/png",
      })
    )
 
    return {
      statusCode: 200,
      body: `Successfully converted ${key} to PNG and uploaded to ${bucket}/${outputKey}`,
    }
  } catch (error) {
    console.error("Error:", error)
    return {
      statusCode: 500,
      body: `Failed to convert ${key} to PNG: ${error.message}`,
    }
  } finally {
    if (browser !== null) {
      await browser.close()
    }
  }
}

次に、svg-to-png ディレクトリ内で以下のコマンドを実行し、依存関係をインストールして必要なファイルを zip 化します。

npm install --omit=dev && \
zip -r svg-to-png.zip index.mjs node_modules package.json

svg-to-png.zip ファイルを Lambda 関数の “コードソース” > “アップロード元” > “zip ファイル” にアップロードします。

ステップ 4: S3 イベントトリガーを設定する

SVG ファイルを処理するために Lambda 関数に S3 イベントトリガーを設定します。

  1. “トリガーを追加” に移動
  2. S3 を選択し、希望のバケットを選択
  3. イベントタイプには “すべてのオブジェクト作成イベント” を選択
  4. プレフィックスまたはサフィックスオプションには希望の値を入力(例: プレフィックスの場合は svgs/、サフィックスの場合は .svg)

ステップ 5: Lambda 関数をテストする

SVG ファイルを S3 バケットにアップロードし、変換ステータスのために Lambda 関数のログを確認します。

Chromium を実行しているため、変換プロセスに数秒から数分かかることがあります。

PNG ファイルが同じ S3 バケットに作成され、foreignObject 要素を含む期待されるコンテンツがあることを確認します。

結論

このチュートリアルでは、Headless Chrome と AWS Lambda を使用して SVG ファイルを PNG に変換する方法を示しました。これは、foreignObject やカスタムフォントを持つ text 要素など、多くの画像処理ライブラリでサポートされていない要素を含む SVG ファイルをラスタライズする必要がある場合に便利です。Headless ブラウザを使用することで、ブラウザのレンダリングエンジンを利用してこれらの複雑な SVG を正確にレンダリングできます。

一度 Lambda 関数を設定すれば、複数の SVG ファイルを同時に処理するソリューションに簡単にスケールアップできます。

その後、Imgix を使用して PNG ファイルを提供し、必要に応じてさらなる変換や最適化を適用できます。

参考資料