大网数据广告活动
Web 标准与前端开发

ArrayBuffer() 构造函数

· 52CE 我爱测

**`ArrayBuffer()`** 构造函数创建 ArrayBuffer 对象。

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),以减少内存溢出风险。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。