WASM を同梱した npm ライブラリで、.wasm ファイルはどこを通ってブラウザに届くか
JS だけのライブラリなら「npm に置けば、利用者のバンドラーが混ぜてくれる」で済む。 WASM を同梱すると `.wasm` というバイナリファイルが関わるため、関わる場所が 5 つに分かれ、それぞれで壊れ方が違う。
ライブラリ名・ファイル名の my-lib / x.wasm は抽象的な代表例。カードが置かれたセルがそのファイルの初登場。
配布フロー図
JS だけのライブラリとの違い
項目 | JS だけ | WASM を同梱 |
|---|---|---|
パッケージの中身 | lib/esm / lib/cjs / 型定義 | + .wasm バイナリ |
読み込み | import した時点で使える | 取得 + コンパイルが非同期 |
API | 同期で返せる | await が要る。または JS 版で先に動かし、後から差し替える |
ファイル位置の解決 | 不要 | new URL('./x.wasm', import.meta.url)。CJS では import.meta.url が使えない |
base64 で JS に埋め込む | — | 位置の問題は消えるがサイズ約 1.33 倍。非同期は残る |
CDN から 1 行 | そのまま動く | 同じ場所から配信されるので動く。リクエストは 1 回増える |
CSP | 制約なし | 'wasm-unsafe-eval' が要る |
ビルドと CI | tsc だけ | Rust 等のツールチェーンが増える |
デバッグ | DevTools でそのまま | 追いにくい。テストは JS 版と結果が一致するかの比較が中心 |
参考: MDN WebAssembly