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);
});
标准规范
Specification |
---|
WebAssembly JavaScript Interface # memories |
Unknown specification |
浏览器兼容性
webassembly.api.Memory
BCD tables only load in the browser
webassembly.multiMemory
BCD tables only load in the browser