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

SharedArrayBuffer.prototype.grow()

· 52CE 我爱测

SharedArrayBuffer 实例的 **`grow()`** 方法将 `SharedArrayBuffer` 增大到以字节为单位的指定大小。

SharedArrayBuffer 实例的 grow() 方法将 SharedArrayBuffer 增大到以字节为单位的指定大小。

语法

grow(newLength)

参数

  • newLength
    • : 新的长度,以字节为单位,SharedArrayBuffer 调整后的大小。

返回值

无(undefined)。

异常

  • TypeError
    • : 如果当前的 SharedArrayBuffer 不可增大,则抛出该异常。
  • RangeError
    • : 如果 newLength 大于当前 SharedArrayBuffer 的 SharedArrayBuffer/maxByteLength 或小于 SharedArrayBuffer/byteLength,则抛出该异常。

描述

grow() 方将 SharedArrayBuffer 增大到 newLength 参数指定的大小,前提是 SharedArrayBuffer 是可增大的,并且新的大小小于等于当前 SharedArrayBuffer 的 SharedArrayBuffer/maxByteLength。新字节被初始化为 0。

示例

使用 grow()

在这个示例中,我们创建一个 8 字节缓冲区,该缓冲区可调整大小到的最大长度是 16 字节,然后检查其 SharedArrayBuffer/growable 属性,如果 growable 返回 true,则将其增大:

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

if (buffer.growable) {
  console.log("SAB 是可增大的!");
  buffer.grow(12);
}

规范

浏览器兼容性

参见

  • SharedArrayBuffer
  • SharedArrayBuffer.prototype.growable
  • SharedArrayBuffer.prototype.maxByteLength

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

资料来源与适用范围

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

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

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