SharedArrayBuffer.prototype.maxByteLength

Baseline 2024
新推出

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

maxByteLength 訪問器屬性是 SharedArrayBuffer 例項的屬性,它返回此 SharedArrayBuffer 可以增長到的最大長度(以位元組為單位)。

描述

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

如果此 SharedArrayBuffer 在構造時未指定 maxByteLength 值,則此屬性將返回一個等於 SharedArrayBufferbyteLength 值的屬性。

示例

使用 maxByteLength

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

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

buffer.maxByteLength; // 16

規範

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

瀏覽器相容性

另見