ArrayBuffer() 构造函数创建 ArrayBuffer 对象。
JavaScript Demo: ArrayBuffer Constructor
// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(8);
console.log(buffer.byteLength);
// Expected output: 8
语法
new ArrayBuffer(length)
new ArrayBuffer(length, options)
[!NOTE]
ArrayBuffer()只能使用new构造。尝试在没有new的情况下调用会抛出 TypeError。
参数
length- : 要创建的数组缓冲区的大小(以字节为单位)。
options- : 一个对象,可以包含以下属性:
maxByteLength- : 数组缓冲区可以调整到的最大大小,以字节为单位。
- : 一个对象,可以包含以下属性:
返回值
一个指定大小的新 ArrayBuffer 对象,其 ArrayBuffer/maxByteLength 属性设置为指定的 maxByteLength(如果指定了该值),其内容被初始化为 0。
异常
- RangeError
- : 有下列情况之一时抛出:
length或maxByteLength大于 Number.MAX_SAFE_INTEGER(≥ 2<sup>53</sup>)或者为负数。length大于maxByteLength。
- : 有下列情况之一时抛出:
示例
创建一个 ArrayBuffer
在这个示例中,我们创建一个 8 字节的缓冲区,并使用一个 Int32Array 视图来引用该缓冲区:
const buffer = new ArrayBuffer(8);
const view = new Int32Array(buffer);
创建一个可以调整大小的 ArrayBuffer
在这个示例中,我们创建一个 8 字节的缓冲区,它可以调整到的最大长度为 16 字节,然后使用 ArrayBuffer/resize 调整到 12 字节:
const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
buffer.resize(12);
[!NOTE] 推荐将
maxByteLength设置为使用场景下最小的大小。它不应超过1073741824(1GB),以减少内存溢出风险。
规范
浏览器兼容性
参见
core-js中ArrayBuffer的 polyfill- JavaScript 类型化数组指南
- SharedArrayBuffer
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
