[!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)以减小内存溢出风险。
规范
浏览器兼容性
参见
- Atomics
- ArrayBuffer
- JavaScript 类型化数组指南
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
