【入門編】WebAssemblyとJavaScriptのスコープ境界:変数の受け渡しにおけるメモリ管理 – JavaScriptコア文法・モダン言語仕様と変数・関数解析バイブル

こんにちは!普段はJavaScriptやV8エンジン、ブラウザの内部挙動と向き合いながら、アーキテクトとして日々コードを書いています。

今回は、JavaScriptとWebAssembly(Wasm)という、一見するとまったく異なる世界をつなぐ「スコープ境界」と「メモリ管理」のお話です。

「JavaScriptだけでも大変なのに、Wasmなんてまだ早いよ…」なんて思っていませんか?
大丈夫です。ここをクリアすれば、JavaScriptと低レイヤー言語の境界線で何が起きているのかが手に取るように分かり、パフォーマンスのボトルネックを自力で解消できる本物のエンジニアに一歩近づけますよ。それでは、優しく丁寧に紐解いていきましょう!

—

1. なぜJavaScriptとWasmの間で「データの壁」があるのか?

私たちが普段書いているJavaScriptのオブジェクトや配列は、V8エンジンの「ガベージコレクション(GC)付きのヒープ領域」という、何でも自動でお片付けしてくれる広大なアパートメントに住んでいます。

一方、C言語やRustなどで書かれてWebAssemblyにコンパイルされた世界は、もっと厳格で冷徹です。Wasmの世界には、GCの概念がありません。そこにあるのは、ただひとつの巨大な「直線的なメモリの塊(Linear Memory)」という名のコンクリートの床だけです。

[ JavaScriptの世界 ] [ WebAssemblyの世界 ]
V8ヒープ (自由な空間/GCあり) 直線的メモリ (ただのバイト配列)

  • プレーンなオブジェクト – 型付けされた生データ (ArrayBuffer)
  • 動的な配列 – ポインタとオフセット

\ /
\—–> 【スコープ境界】 <---------/ (ここでデータ変換が発生) この2つの異なる世界がデータをやり取りするとき、JavaScriptの変数(スコープ内にあるオブジェクトなど)をそのままWasmへ「ポイッ」と投げ渡すことはできません。お互いの言語が理解できる共通の言語、あるいは専用のメモリー橋を渡す必要があるのです。

—

2. 基本的なデータの受け渡し:プリミティブとメモリの覗き見

まずは、一番シンプルな数値のやり取りから見てみましょう。
WebAssemblyのモジュールに数値を渡し、計算結果を受け取るコードです。

// WebAssemblyモジュール(バイナリを模した仮想的な例)をロードするイメージ
async function loadWasm() {
// コンパイル済みのWasmバイナリを読み込むと仮定
const response = await fetch(‘calculator.wasm’);
const buffer = await response.arrayBuffer();

// インスタンス化してエクスポートされた関数を取り出す
const { instance } = await WebAssembly.instantiate(buffer);
const { add, memory } = instance.exports;

// — ここからがスコープとデータのやり取り —

// JavaScriptのスコープで数値を定義
let a = 10;
let b = 20;

// Wasmの関数を呼び出す(プリミティブな数値は直接コピーして渡せる)
let result = add(a, b);

console.log(`JS側での計算結果: ${result}`); // 出力: 30
}

loadWasm();

ここで何が起きているのか?

数値(`Number`)のようなプリミティブ型は非常に小さいため、JSのスコープからWasmの関数へ値そのものがコピーされて渡されます。ここはまだ怖くありません。

問題は、「文字列」や「大きな配列」をやり取りするときです。これらをそのまま渡そうとすると、裏側で大きなデータのコピーが発生し、メモリとCPUのパフォーマンスをゴリゴリと削る原因になってしまいます。

—

3. メモリコピーを最小限にする最適化の極意:共有メモリの活用

大きな配列データをJSとWasmの間でやり取りするとき、毎回データをコピーしていると、ブラウザのメインスレッドがカクつく原因(ジャンク)になります。

ここで登場するのが、`WebAssembly.Memory` という、JSとWasmの両方から同時にアクセスできる「共有の作業スペース」です。これを使うと、データをコピーするのではなく、「同じメモリの場所を二人で見つめ合う(参照を共有する)」というスマートな技が使えます。

実践:メモリを直接共有して高速にデータを処理するコード

// 1. メモリをあらかじめ確保する(ページ単位: 1ページ = 64KB)
const memory = new WebAssembly.Memory({ initial: 1, maximum: 10 });

// 2. Wasmモジュールにメモリを渡してインスタンス化
const importObject = {
env: {
sharedMemory: memory
}
};

async function runOptimizationDemo() {
const response = await fetch(‘array_processor.wasm’);
const { instance } = await WebAssembly.instantiate(
await response.arrayBuffer(),
importObject
);

const { processArray } = instance.exports;

// — メモリの「ビュー(窓)」を作る —
// Wasmのメモリ空間を、JavaScript側から「符号なし32ビット整数」の配列として覗き見る
const jsArrayView = new Uint32Array(memory.buffer);

// データを書き込む(コピーではなく、共有メモリへ直接書き込む!)
for (let i = 0; i < 5; i++) { jsArrayView[i] = (i + 1) 100; // [100, 200, 300, 400, 500] } console.log("Wasm処理前のJSビュー:", jsArrayView.slice(0, 5)); // Wasm側に「メモリの何番目から、いくつデータがあるよ」というポインタ(オフセット)だけを伝える // データをコピーしないので、極めて高速! processArray(0, 5); console.log("Wasm処理後のJSビュー:", jsArrayView.slice(0, 5)); // 出力例: [101, 201, 301, 401, 501] (Wasm側で各要素に1が足されたとする) } runOptimizationDemo();

このコードが美しい理由

JavaScriptのスコープ内にある変数が指し示す `memory.buffer` は、Wasm側から見える直線的メモリと完全に同一の物理メモリ領域を指しています。
つまり、データを「送受信」しているのではなく、「二人で同じホワイトボードを共有して書き込んでいる」状態なわけです。これにより、無駄なメモリコピーのオーバーヘッドをゼロに近づけることができます。

—

4. 陥りやすい罠:メモリの「再割り Allocate(リサイズ)」による参照の切断

初心者が絶対にハマる致命的なミスについても触れておきますね。

Wasmのメモリが足りなくなって `memory.grow()` などでメモリサイズが拡張されたとき、V8エンジンは新しい広さを確保するために、裏側でメモリの置き場所(バッファ)そのものを丸ごと別の安全な場所へ引っ越しさせることがあります。

// ⚠️ 危険なアンチパターン
let memory = new WebAssembly.Memory({ initial: 1 });
let view = new Uint32Array(memory.buffer); // ここでビューを作る

// … どこかでWasm側、あるいはJS側でメモリが拡張される …
memory.grow(1);

// この瞬間、最初の `view` が見ている buffer は「古い廃墟(デタッチされたバッファ)」になる!
view[0] = 42; // TypeError: Cannot perform %TypedArray%.prototype.set on a detached ArrayBuffer

対策

メモリが拡張された可能性があるときは、必ずビュー(`TypedArray`)を再生成するのが鉄則です。

// メモリが拡張されたら、必ずビューを張り直す!
function getFreshView(memory) {
return new Uint32Array(memory.buffer);
}

この一手間を知っているだけで、本番環境での謎のクラッシュを華麗に回避できるようになります。

—

まとめ

いかがでしたでしょうか?
JavaScriptとWebAssemblyの境界線におけるメモリ管理は、一見難しそうに見えますが、本質はシンプルです。

1. プリミティブはコピーされて渡るが、大きなデータはそのままでは重い。
2. `WebAssembly.Memory` と `TypedArray` を使ってメモリを共有することで、コピーを極限まで減らせる。
3. メモリが成長(拡張)したときのビューの切断(Detached ArrayBuffer)に気を付ける。

ここをクリアできれば、あなたはもう表面的なAPIの使い方だけに頼るエンジニアではありません。ランタイムのメモリの息づかいまで感じ取れる、ワンランク上のフルスタックエンジニアです。

今日の学びを武器に、ぜひ次のパフォーマンスチューニングに挑んでみてくださいね。あなたの開発ライフがよりエキサイティングなものになりますように!

タイトルとURLをコピーしました