WebAssembly

どのようなものか

WebAssemblyは、通常Wasmと略される、実行可能なコードのバイナリ形式で
す。コア仕様では「効率的な実行とコンパクトな表現を目的とした、安全で
移植可能な低水準のコード形式」と定義され、仮想的な命令セットとして説
明されています。つまり、架空のプロセッサー向けの命令を、ブラウザーな
どのホストがまず検証し、実際のプロセッサーの機械語に変換します。Wasm
は単語を縮めた表記で、頭文字を並べた略語ではありません。そのため、仕
様でもWASMではなくWasmと書かれています。

`.wasm`ファイルは、通常、別の言語のコンパイラーが出力したものです。
仕様によれば、主な目的はウェブ上のアプリケーションを高速に動かすこと
ですが、形式自体はウェブを前提としていません。そのため、単独の仮想マ
シンとしても、別のプログラムの内部でも実行できます。標準もそれに合わ
せて層に分かれています。コア仕様が定めるのは命令、形式、検証、実行で
あり、特定の実行環境ではありません。モジュールのコンパイル、リンク、
呼び出しを行うJavaScript
APIと、ネットワークから読み込むWeb APIは、それぞれ別の文書で定義され
ています。

最初の版は2019年12月5日にW3C勧告になりました。後継版より3年早く実質
的に完成していた2.0では、ベクトルを扱う命令、メモリーの一括操作、複
数の戻り値を持つ関数、参照型の初歩的な仕組みが加わりました。2025年9
月17日、プロジェクトは3.0を現行の標準として発表し、主要ブラウザーの
大半ですでに提供されていると説明しました。同じ発表では、Wasmのガベー
ジコレクターを利用してWasm向けにコンパイルできる言語として、Java、
OCaml、Scala、Kotlin、Scheme、Dartなどが挙げられています。

基本用語は多くありません。コードの単位はモジュールです。関数、テーブ
ル、メモリー、グローバル変数を持ち、必要なものをインポートします。各
インポートはモジュール名と項目名で指定し、外部に提供するものは独自の
名前でエクスポートします。数値型は、32ビットと64ビットの整数および浮
動小数点数である`i32`、`i64`、`f32`、`f64`の4種類です。このほか、128
ビットのベクトル型1種類と、内部構造を直接扱えない参照があります。整
数自体には符号の区別がなく、各演算が符号付きか符号なしかを決めて解釈
します。32ビット整数は真偽値にも使われ、メモリーアドレスには`i32`を
使い、64ビットメモリーでは`i64`を使います。命令は暗黙のスタックから
オペランドを取り出し、結果を同じスタックに置きます。制御フローは構造
化されており、ブロック、ループ、条件分岐が入れ子になり、分岐先にでき
るのはそのいずれかだけです。

バイト単位でアドレスを指定するデータは、線形メモリーに置かれます。こ
れは連続した書き込み可能なバイト配列で、宣言したサイズから始まり、実
行中に拡張できます。現在の範囲を外れた読み書きが、別の領域に届くこと
はありません。その場合はトラップが発生し、実行が直ちに停止します。ト
ラップはWasm内で処理できず、周囲のホストに報告されるだけです。以下の
例では、仕様が人間の可読性のために定めたテキスト形式を使います。

なぜ重要なのか

第1の理由は速度です。設計目標には、ネイティブコードに近い性能と、JIT
でもAOTでも高速な1回の走査でデコード、検証、コンパイルできる形式が掲
げられています。バイナリは、テキストやネイティブの機械語より小さくな
るよう設計され、ストリーミングにも対応します。最後のバイトが届く前に
処理を始められます。バイナリ形式では、各関数の型宣言と本体さえ別のセ
クションに置くため、本体を受信しながら並列にコンパイルできます。別の
言語で十分にテストされたライブラリーを持つチームなら、JavaScriptで書
き直さず、ブラウザー向けにコンパイルできます。

第2の理由は移植性です。同じモジュールを、デスクトップでもモバイルで
も、現在のどのプロセッサーでも実行できます。また、エンジンを組み込ん
だホストなら、ブラウザー、単独のランタイム、別のプログラムのいずれで
も動きます。仕様は特定の言語、プログラミングモデル、オブジェクトモデ
ルを優遇しません。したがって、この形式は1つの言語専用のランタイムで
はなく、共通のコンパイル先になります。

第3の理由は隔離です。モジュールには、実行先のコンピューターを暗黙に
操作する権限がありません。ホストが対応する関数をモジュールへのイン
ポートとして渡さない限り、ファイル、ネットワーク、ページ、時計にはア
クセスできず、触れてよいものをホストが厳密に決めます。Web
APIでは、WasmはJavaScriptを実行できる場所で実行でき、脅威モデルも基
本的に同じで、JavaScriptで公開できる範囲を超えて機能を公開できないと
説明しています。3.0では、この境界の内側で扱えるものが増えました。64
ビットでアドレスを指定するメモリーは、ウェブ上では16ギガバイトに制限
されます。このほか、1モジュール内の複数メモリー、ガベージコレクショ
ンを必要とする言語向けの仕組み、ホストまで逃がさずに扱える例外が加わ
りました。発表では、例外をホストに逃がす方法は、移植性にも効率にも欠
けると説明されています。

実際の活用例

次は、32ビット整数2つを加算する関数を1つだけエクスポートする、テキス
ト形式のモジュールです。

```wat
(module
  (func (export "add") (param i32 i32) (result i32)
    local.get 0
    local.get 1
    i32.add))
```

関数の型は、2つの`i32`を受け取り、1つを返すことを示しています。本体
はスタックを操作する3命令です。`local.get
0`が第1引数を、`local.get
1`が第2引数を積み、`i32.add`が両方を取り出して和を積みます。その和が
結果としてスタックに残ります。`(export
"add")`は外部から見える関数名を指定します。バイナリ形式に変換する
と、ファイルは`0x00 0x61 0x73
0x6D`という4バイト、つまりゼロと文字列asmで始まり、その後にバイナリ
形式のバージョンが続きます。このバージョンは今も1です。

ブラウザーでは、JavaScript APIで読み込みます。

```js
const url = "/add.wasm";
const { instance } = await WebAssembly.instantiateStreaming(fetch(url));
instance.exports.add(2, 3); // 5
instance.exports.add(2147483647, 1); // -2147483648
```

`instantiateStreaming`は、応答を受信している間にモジュールをコンパイ
ルし、コンパイル済みモジュールとそのインスタンスを返してPromiseを解
決します。インスタンスのエクスポートは、通常のJavaScript関数です。2
回目の呼び出しは、型の意味を示しています。Wasmの整数加算は2の32乗を
法として循環し、JavaScript
APIは`i32`の結果を符号付き整数として解釈します。そのため、正の最大値
に1を足すと、最小の負の値が返ります。例外は投げられません。一方、ト
ラップが起きると例外になります。関数が自身のメモリーの範囲外を読む
と、呼び出しは`WebAssembly.RuntimeError`で終了します。

ホストから何かを必要とするモジュールは、その要求を宣言します。モ
ジュールに`(import "env" "log" (func
(param i32)))`があれば、インスタンス化には第2引数として
`{ env: { log: console.log }
}`が必要で、モジュールは`log`を自身の関数と同様に呼び出せます。第2引
数を省くと`TypeError`になり、`env`オブジェクトに呼び出せる`log`がな
ければ`WebAssembly.LinkError`になります。どちらも、モジュールのコー
ドが動き始める前に失敗します。境界を構成するのはインポートとエクス
ポートだけで、その型は宣言され、数値型や参照型を含みます。モジュール
のメモリー内のアドレスは`i32`で、64ビットメモリーでは`i64`です。

Swift
6でネイティブmacOSクライアントを構築した実績は、別の言語のコードを再
利用する、もう1つの方法を説明しています。2026年8月のこの業務では、
Rustのコアを静的アーカイブとしてSwiftアプリケーションにリンクし、契
約として扱うCインターフェースを通して利用しました。境界を通るポイン
ターと文字列はすべて薄いラッパーが所有し、インターフェースから返るも
のには、それぞれ所有権の規則があります。扱いを誤ると、コンパイラーの
警告もなくリークやクラッシュになります。この業務ではWasmを使っていま
せん。だからこそ比較になります。2つの言語の間に狭い境界を設けるとい
う同じ問題を、インポート一覧とサンドボックス内のメモリーではなく、ネ
イティブリンクで解決した例です。

問題が起きるところ

コンパイル前にPromiseが拒否される。
`Content-Type`がない場合や、大文字と小文字を区別せずに比較しても
`application/wasm`と一致しない場合は、`TypeError`になります。仕様は
追加のパラメーターを認めておらず、`application/wasm;`のようにパラ
メーターが空でも不可としています。成功を表さないステータスや、CORSで
アクセスが許可されていない別オリジンの応答でも、同じように失敗しま
す。サーバーのメディアタイプとヘッダーを修正します。自分で取得したバ
イト列を`WebAssembly.instantiate`に渡せばメディアタイプの検査は省け
ますが、ストリーミングコンパイルも使えなくなります。

メモリーのビューが使えなくなる。
JavaScriptは、`memory.buffer`と、その上に作った配列を通してモジュー
ルのメモリーを参照します。非共有メモリーでは、このバッファーは初期状
態では固定長です。メモリーが拡張されると、JavaScript
APIは固定長バッファーを切り離し、新しいものに置き換えるため、古い
バッファー上の配列はメモリーから切り離されます。これはJavaScriptから
`memory.grow()`を呼んだ後にも、外からは無害に見える呼び出しの途中
で、モジュール内の`memory.grow`命令が実行された後にも起きます。ペー
ジが存在する間ずっと同じビューを保持せず、メモリーを拡張する可能性の
ある呼び出しの後には、`memory.buffer`からビューを作り直します。

Wasmが単独でページを操作できると思う。
モジュールには暗黙のアクセス権がありません。ページ、ネットワーク、ス
トレージへの作用はすべて、JavaScriptがインポートとして渡す関数を通り
ます。型にも、この境界で制約があります。`i64`はNumberではなく
`BigInt`として通り、`v128`を引数または戻り値に持つ関数をJavaScriptか
ら呼ぶと、毎回`TypeError`になります。インポートとエクスポートの一覧
を1つのインターフェースとして設計し、そこでは単純な数値を使い、ベク
トルはWasm側にとどめます。

サンドボックス内ならプログラムも安全だと思う。
サンドボックスは、モジュールがホストに害を及ぼさないように守ります。
モジュール自体を、その内部の誤りから守るわけではありません。仕様で
も、メモリーの安全性を保証しない言語をWasmにコンパイルしたときに、線
形メモリー内の自身の配置を壊すことまでは防げないと明記しています。コ
ンパイルしたコードのバッファーオーバーフローは、モジュール自身のデー
タを上書きします。トラップになるのは、メモリー全体の末尾を超えたアク
セスだけです。元の言語の検査とテストを保ち、モジュールが外部から受け
取るデータは、信頼できない入力として扱います。

バイナリを保護せずに配信する。
`application/wasm`の登録文書は、この形式には完全性や機密性を保護する
仕組みがなく、必要ならHTTPSなどの外部の仕組みで保護しなければならな
いとしています。JavaScriptと同じく、読み込み方や実行方法の一部は、
Content
Security
Policyや同一オリジンポリシーで制限されます。また、Wasmは実際のハード
ウェアで動く機械語になるため、コア仕様はハードウェア層のサイドチャネ
ル攻撃を受ける可能性も指摘しています。モジュールはHTTPSで配信し、ス
クリプトと同じ厳格さで、モジュールを変更できる人を管理します。

参考資料

  * WebAssembly仕様 — バージョン3.0のコア仕様。構造、検証、実行、バ
イナリ形式、テキスト形式を定めています。

  * 概要 — 定義、設計目標、各文書の対象範囲、セキュリティ上の考慮事
項。

  * WebAssembly JavaScriptインターフェース —
JavaScriptからのコンパイルとインスタンス化、値の受け渡し、
`Memory.grow`、3種類のエラークラス。

  * WebAssembly Web API —
`instantiateStreaming`、応答の検査、`application/wasm`の登録。

  * Wasm 3.0の完成 — 2025年9月17日の発表と、3.0で追加された機能。

  * WebAssemblyコア仕様1.0 — 2019年12月5日のW3C勧告。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/webassembly/	engineer.company	70
