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

ArrayBuffer.prototype.transferToFixedLength()

· 52CE 我爱测

ArrayBuffer 实例的 **`transferToFixedLength()`** 方法创建一个不可调整大小的新 `ArrayBuffer` 对象,该对象与此缓冲区具有相同的字节内容,然后将此缓冲区分离。

ArrayBuffer 实例的 transferToFixedLength() 方法创建一个不可调整大小的新 ArrayBuffer 对象,该对象与此缓冲区具有相同的字节内容,然后将此缓冲区分离。

语法

transferToFixedLength()
transferToFixedLength(newByteLength)

参数

  • newByteLength
    • : 新的 ArrayBuffer 的 ArrayBuffer/byteLength。默认为此 ArrayBuffer 的 byteLength。
      • 如果 newByteLength 小于此 ArrayBuffer 的 byteLength,则“溢出的”字节将被丢弃。
      • 如果 newByteLength 大于此 ArrayBuffer 的 maxByteLength,则多余的字节用零填充。

返回值

一个新的 ArrayBuffer 对象。它的内容被初始化为此 ArrayBuffer 的内容,如果有多余的字节,则用零填充。新的 ArrayBuffer 总是不可调整大小的。原始 ArrayBuffer 被分离。

异常

  • TypeError
    • : 如果此 ArrayBuffer 已经分离,则抛出该错误。

描述

和 ArrayBuffer/transfer 不同,transferToFixedLength() 总是创建一个不可调整大小的 ArrayBuffer。这意味着 newByteLength 可以比 maxByteLength 大,即使此 ArrayBuffer 是可调整大小的。有关更多信息,请参阅传输 ArrayBuffer。

示例

将可调整大小的 ArrayBuffer 转换为固定长度

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
const view = new Uint8Array(buffer);
view[1] = 2;
view[7] = 4;

const buffer2 = buffer.transferToFixedLength();
console.log(buffer2.byteLength); // 8
console.log(buffer2.resizable); // false
const view2 = new Uint8Array(buffer2);
console.log(view2[1]); // 2
console.log(view2[7]); // 4

通过使用 transferToFixedLength,newByteLength 可以大于原来的 ArrayBuffer 的 maxByteLength。

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
const view = new Uint8Array(buffer);
view[1] = 2;
view[7] = 4;

const buffer2 = buffer.transferToFixedLength(20);
console.log(buffer2.byteLength); // 20
console.log(buffer2.resizable); // false
const view2 = new Uint8Array(buffer2);
console.log(view2[1]); // 2
console.log(view2[7]); // 4

规范

浏览器兼容性

参见

  • ArrayBuffer
  • ArrayBuffer.prototype.detached
  • ArrayBuffer.prototype.transfer()

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

资料来源与适用范围

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

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

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