Langsung ke konten
Catatan

ID (bahasa aktif)EN

Memuat WebAssembly di Workers dengan impor modul

2 mnt bacaRisqi Romadhoni
  • Cloudflare Workers
  • WebAssembly

Situs ini membuat kartu Open Graph dengan @resvg/resvg-wasm, pustaka WebAssembly yang mengubah SVG menjadi PNG. Di Workers, pustaka ini tidak bisa dimuat dari byte. Cara yang berhasil: impor berkas .wasm-nya sebagai modul.

Kenapa tidak bisa dikompilasi dari byte

Menurut dokumentasi Cloudflare (buka di tab baru), Workers tidak mengizinkan WebAssembly.compile dan WebAssembly.instantiate yang menerima byte, dengan alasan keamanan. Versi streaming-nya, WebAssembly.compileStreaming dan WebAssembly.instantiateStreaming, juga tidak diizinkan.

Impor sebagai modul

Menurut dokumentasi WebAssembly Cloudflare (buka di tab baru), toolchain Cloudflare mengemas berkas .wasm dan .wasm?module ke dalam Worker supaya tersedia saat runtime. Hasil impornya berupa WebAssembly.Module, seperti tertulis di dokumentasi adapter Cloudflare untuk Astro (buka di tab baru). Kode yang membuat kartu di situs ini memakai akhiran ?module:

src/shared/lib/og-image/render.ts
import { initWasm, Resvg } from "@resvg/resvg-wasm";
import rasteriserModule from "@resvg/resvg-wasm/index_bg.wasm?module";

Dengan modul, initWasm memanggil WebAssembly.instantiate dengan modul itu, bukan dengan byte. Kalau diberi URL atau Response, ia memakai instantiateStreaming, atau instantiate dengan byte. Workers tidak mengizinkan kedua jalur itu. Panggilan kedua initWasm melempar error, jadi kode menyimpan promise-nya di rasteriserReady dan memakainya lagi.

Kapan kartu dibuat

Rute kartu OG, src/pages/og/[...path].png.ts, memakai prerender = true. Jadi kartu dibuat saat build, bukan saat ada permintaan. Keluaran build situs ini memperlihatkan hal itu. Ada folder og di folder keluaran client, sedangkan folder server tidak memuat berkas .wasm atau kode resvg.

Adapter Cloudflare untuk Astro menjalankan prerender di workerd secara bawaan. Opsi prerenderEnvironment (buka di tab baru) mengaturnya. Alasannya, menurut dokumentasi: supaya sedekat mungkin dengan lingkungan produksi. astro.config.mjs di situs ini tidak mengubah opsi itu.

Ada yang keliru? Kabari saya