ArrayBuffer.prototype.maxByteLength
Baseline
2024
Newly available
Since July 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
ArrayBuffer 实例的 maxByteLength 访问器属性返回该数组缓冲区可调整到的最大长度（以字节为单位）。
尝试一下
const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
console.log(buffer.byteLength);
// Expected output: 8
console.log(buffer.maxByteLength);
// Expected output: 16
描述
maxByteLength 属性是一个访问器属性，其设置访问器函数为 undefined，这意味着你只能读取此属性。该值在构造数组时通过 ArrayBuffer() 构造函数的 maxByteLength 选项设置，并且不能更改。
如果该 ArrayBuffer 已分离，则该属性返回 0。如果该 ArrayBuffer 构造时未指定 maxByteLength 值，则该属性返回 ArrayBuffer 的 byteLength 值。
示例
使用 maxByteLength
在该示例中，我们创建一个 8 字节缓冲区，该缓冲区可调整到的最大长度为 16 字节，然后返回其 maxByteLength：
js
const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
buffer.maxByteLength; // 16
规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-get-arraybuffer.prototype.maxbytelength |
浏览器兼容性
Loading…