WebAssembly.Memory

コンストラクター

WebAssembly.Memory()

新しい Memory オブジェクトを生成します。

インスタンスプロパティ

Memory.prototype.buffer 読取専用

メモリーに格納されているバッファーを返します。

インスタンスメソッド

Memory.prototype.grow()

指定した WebAssembly ページ (64KiB で 1 単位) の数でメモリーのインスタンスのサイズを増やします。

例

新しい Memory オブジェクトの生成

WebAssembly.Memory オブジェクトを取得する方法は 2 つあります。 1 つ目は JavaScript から生成する方法です。以下の例では、初期サイズが 10 ページ (640KiB) 、最大サイズが 100 ページ (6.4MiB) で新しい WebAssembly Memory インスタンスを生成しています。その buffer プロパティは ArrayBuffer を返します。

const memory = new WebAssembly.Memory({
  initial: 10,
  maximum: 100,
});

次の例では (GitHub 上の memory.html および実行例も参照)、 "memory.wasm" バイトコードを WebAssembly.instantiateStreaming() メソッドを使用して読み込んでインスタンス化し、その上の行で生成されたメモリーにインポートします。それから、メモリーにいくつかの値を格納し、関数をエクスポートして使用し、それらの値を合計します。DataView を使用してメモリーにアクセスしているため、常にリトルエンディアン形式が使用される点に注意してください。

const memory = new WebAssembly.Memory({
  initial: 10,
  maximum: 100,
});

WebAssembly.instantiateStreaming(fetch("memory.wasm"), {
  js: { mem: memory },
}).then((obj) => {
  const summands = new DataView(memory.buffer);
  for (let i = 0; i < 10; i++) {
    summands.setUint32(i * 4, i, true); // WebAssembly is little endian
  }
  const sum = obj.instance.exports.accumulate(0, 10);
  console.log(sum);
});

WebAssembly.Memory オブジェクトを取得する 2 つ目の方法は、 WebAssembly モジュールによってエクスポートされることです。このメモリーは WebAssembly インスタンスの exports プロパティで (メモリーが WebAssembly モジュール内でエクスポートされた後に) アクセスできます。次のスニペットは、 WebAssembly からエクスポートされたメモリーを memoryという名前でインポートし、メモリーの最初の要素を Uint32Array として解釈して表示しています。

WebAssembly.instantiateStreaming(fetch("memory.wasm")).then((obj) => {
  const values = new DataView(obj.instance.exports.memory.buffer);
  console.log(values.getUint32(0, true));
});

共有メモリーの作成

デフォルトでは、 WebAssembly のメモリーは共有されていません。共有メモリーを JavaScript で作成するには、コンストラクターの初期化オブジェクトに shared: true を渡します。

const memory = new WebAssembly.Memory({
  initial: 10,
  maximum: 100,
  shared: true,
});

このメモリーの buffer プロパティは SharedArrayBuffer を返します。

64 ビットアドレスの使用

次のスニペットは、64 ビットのアドレス型を持つ新しい WebAssembly メモリーインスタンスを作成します。 initial および maximum の値は、BigInt の値でなければなりません：

const memory = new WebAssembly.Memory({
  address: "i64",
  initial: 1n,
  maximum: 10n,
});

仕様書

ブラウザーの互換性

webassembly.api.Memory

webassembly.multiMemory

関連情報

• WebAssembly 概要
• WebAssembly の概要
• WebAssembly JavaScript API の使用