ArrayBuffer.prototype.maxByteLength

基线 2024

新可用

2024年7月起,此功能在最新的设备和浏览器版本中均可使用。此功能可能在较旧的设备或浏览器中无法使用。

maxByteLengthArrayBuffer 实例的访问器属性,它返回此数组缓冲区可以调整到的最大长度(以字节为单位)。

试一试

描述

maxByteLength 属性是一个访问器属性,其 set 访问器函数为 undefined,这意味着你只能读取此属性。该值在数组构造时建立,通过 ArrayBuffer() 构造函数的 maxByteLength 选项设置,并且不能更改。

如果此 ArrayBuffer 已分离,则此属性返回 0。如果此 ArrayBuffer 在未指定 maxByteLength 值的情况下构造,则此属性返回一个等于 ArrayBufferbyteLength 值的值。

示例

使用 maxByteLength

在此示例中,我们创建一个 8 字节的缓冲区,其大小可调整到最大 16 字节,然后返回其 maxByteLength

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

buffer.maxByteLength; // 16

规范

规范
ECMAScript 语言规范
# sec-get-arraybuffer.prototype.maxbytelength

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅