ArrayBuffer.prototype.maxByteLength

Baseline 2024
新推出

自 ⁨2024 年 7 月⁩起,此功能可在最新的裝置和瀏覽器版本上使用。此功能可能無法在較舊的裝置或瀏覽器上使用。

maxByteLength 訪問器屬性,屬於 ArrayBuffer 例項,用於返回此 ArrayBuffer 可以調整到的最大長度(以位元組為單位)。

試一試

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

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

console.log(buffer.maxByteLength);
// Expected output: 16

描述

maxByteLength 屬性是一個訪問器屬性,其 set 訪問器函式為 undefined,這意味著您只能讀取此屬性。該值在構造 ArrayBuffer 時確立,透過 ArrayBuffer() 建構函式的 maxByteLength 選項設定,並且無法更改。

如果此 ArrayBuffer 已被分離(detached),則此屬性返回 0。如果此 ArrayBuffer 在構造時未指定 maxByteLength 值,則此屬性返回的值等於該 ArrayBufferbyteLength 的值。

示例

使用 maxByteLength

在此示例中,我們建立一個 8 位元組的緩衝區,該緩衝區可調整大小的最大長度為 16 位元組,然後返回其 maxByteLength

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

buffer.maxByteLength; // 16

規範

規範
ECMAScript® 2026 語言規範
# sec-get-arraybuffer.prototype.maxbytelength

瀏覽器相容性

另見