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

SharedArrayBuffer() 构造函数

· 52CE 我爱测

> [!NOTE] > `SharedArrayBuffer` 构造函数可能并不总是全局可用的,除非满足某些安全要求。

[!NOTE] SharedArrayBuffer 构造函数可能并不总是全局可用的,除非满足某些安全要求。

SharedArrayBuffer() 构造函数创建 SharedArrayBuffer 对象。

JavaScript Demo: SharedArrayBuffer Constructor

// Create a SharedArrayBuffer with a size in bytes
const buffer = new SharedArrayBuffer(8);

console.log(buffer.byteLength);
// Expected output: 8

语法

new SharedArrayBuffer(length)
new SharedArrayBuffer(length, options)

[!NOTE] SharedArrayBuffer() 只能通过 new 来调用。不带 new 调用会抛出 TypeError。

参数

  • length
    • : 要创建的数组缓冲区大小,以字节为单位。
  • options
    • : 一个对象,包含以下属性:
      • maxByteLength
        • : 该共享数组缓冲区可以调整到的最大大小,以字节为单位。

返回值

一个指定大小的新 SharedArrayBuffer 对象,如果指定了 maxByteLength,则其 SharedArrayBuffer/maxByteLength 属性被设置为指定的值。其内容被初始化为 0。

示例

总是使用 new 运算符来创建 SharedArrayBuffer

SharedArrayBuffer 构造函数必须使用 new 运算符来构造。将 SharedArrayBuffer 构造函数作为函数,不通过 new 调用会抛出 TypeError。

const sab = SharedArrayBuffer(1024);
// TypeError: calling a builtin SharedArrayBuffer constructor
// 不带 new 调用是不行的
const sab = new SharedArrayBuffer(1024);

增大可增大的 SharedArrayBuffer

在这个示例中,我们创建了一个 8 字节的缓冲区,其可增大到的最大长度为 16 字节,然后 SharedArrayBuffer/grow 它到 12 字节:

const buffer = new SharedArrayBuffer(8, { maxByteLength: 16 });

buffer.grow(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

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

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