SharedArrayBuffer.prototype.maxByteLength

基线 2024

新功能

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

maxByteLengthSharedArrayBuffer 实例的访问器属性,它返回此 SharedArrayBuffer 可以增长到的最大长度(以字节为单位)。

描述

maxByteLength 属性是一个访问器属性,其设置访问器函数为 undefined,这意味着您只能读取此属性。该值在创建共享数组时通过 SharedArrayBuffer() 构造函数的 maxByteLength 选项进行设置,并且无法更改。

如果此 SharedArrayBuffer 在未指定 maxByteLength 值的情况下创建,则此属性返回的值等于 SharedArrayBufferbyteLength 的值。

示例

使用 maxByteLength

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

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

buffer.maxByteLength; // 16

规范

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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅