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

ArrayBuffer.prototype.resize()

· 52CE 我爱测

ArrayBuffer 实例的 **`resize()`** 方法将 `ArrayBuffer` 调整为指定的大小,以字节为单位。

ArrayBuffer 实例的 resize() 方法将 ArrayBuffer 调整为指定的大小,以字节为单位。

JavaScript Demo: ArrayBuffer.resize()

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

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

buffer.resize(12);

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

语法

resize(newLength)

参数

  • newLength
    • : ArrayBuffer 要调整到的新的长度,以字节为单位。

返回值

无(undefined)。

异常

  • TypeError
    • : 如果 ArrayBuffer 已分离或不可调整大小,则抛出该错误。
  • RangeError
    • : 如果 newLength 大于该 ArrayBuffer 的 ArrayBuffer/maxByteLength,则抛出该错误。

描述

resize() 方法将 ArrayBuffer 调整为 newLength 参数指定的大小,前提是该 ArrayBuffer 是可调整大小的并且新的大小小于或等于该 ArrayBuffer 的 ArrayBuffer/maxByteLength。新字节被初始化为 0。

请注意,你可以使用 resize() 来缩小和增大 ArrayBuffer——即使 newLength 小于 ArrayBuffer 的当前 ArrayBuffer/byteLength。

示例

使用 resize()

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

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

if (buffer.resizable) {
  console.log("缓冲区大小是可调整的!");
  buffer.resize(12);
}

规范

浏览器兼容性

参见

  • ArrayBuffer
  • ArrayBuffer.prototype.resizable
  • ArrayBuffer.prototype.maxByteLength

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

资料来源与适用范围

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

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

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