WebAssembly.Memory()

WebAssembly.Memory()构造函数创建一个新的Memory对象。该对象的buffer属性是一个可调整大小的 ArrayBuffer ，其内存储的是 WebAssembly 实例所访问内存的原始字节码。

从 JavaScript 或 WebAssembly 中所创建的内存，可以由 JavaScript 或 WebAssembly 来访问及更改。

语法

var myMemory = new WebAssembly.Memory(memoryDescriptor);

参数

memoryDescriptor

一个可包含以下成员的对象:

initial

WebAssembly 内存的初始大小，以 WebAssembly 页面为单位。

maximum 可选

以 WebAssembly 页面为单位，可允许 WebAssembly 内存的最大值。当存在此属性时，此参数用于提示引擎预先保留内存。但是，引擎可能会忽略或限制此预留请求。通常情况下大多数 WebAssembly 模块不需要设置最大值。

注意: A WebAssembly 页面的大小为一个常量 65,536 字节，即64KB。

异常

• 如果memoryDescriptor的类型不是对象，则抛出TypeError异常。
• 如果指定了maximum并且小于initial，则抛出RangeError异常。

Memory实例

所有Memory实例都继承自Memory()构造函数的原型对象—这个原型可被修改并影响到所有的Memory实例。

实例属性

Memory.prototype.constructor

返回创建此对象实例的函数。默认情况下，它是WebAssembly.Memory()构造函数。

Memory.prototype.buffer

一个访问器，用于返回内存中包含的缓冲区。

实例方法

Memory.prototype.grow()

通过指定 WebAssembly 页面数量来增加内存实例的大小。（每个页面大小为64KB）

示例

有两种方法可以获得WebAssembly.Memory对象。第一种方法是由 JavaScript 来创建。以下示例创建了一个新的 WebAssembly 内存实例，初始大小为 10页（640KB），最大值设置为 100页（6.4MB）。

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

获取WebAssembly.Memory对象的第二种方法是从 WebAssembly 模块中导出。以下示例（详见GitHub页面 memory.html ，也可以用浏览器运行查看）使用WebAssembly.instantiateStreaming()方法实例化已加载的 memory.wasm 字节代码，同时导入上面一行中创建的内存。用它来存储一些值，然后导出一个函数并用它来对一些值进行求和操作。

WebAssembly.instantiateStreaming(fetch('memory.wasm'), { js: { mem: memory } })
.then(obj => {
  var i32 = new Uint32Array(memory.buffer);
  for (var i = 0; i < 10; i++) {
    i32[i] = i;
  }
  var sum = obj.instance.exports.accumulate(0, 10);
  console.log(sum);
});