SharedArrayBuffer.prototype.maxByteLength
Baseline
2024
最近利用可能
July 2024以降、この機能は最新のバージョンの端末およびブラウザーで動作します。古い端末やブラウザーでは動作しないことがあります。
maxByteLength は SharedArrayBuffer インスタンスのアクセサープロパティで、この SharedArrayBuffer が伸長できる最大長(バイト単位)を返します。
解説
maxByteLength プロパティはアクセサプロパティであり、その set アクセサ-関数は undefined です。つまり、このプロパティは読み取り専用です。この値は、この共有配列が構築されたときに設定され、 SharedArrayBuffer() コンストラクターの maxByteLength オプションを介して設定され、変更することはできません。
この SharedArrayBuffer が maxByteLength 値を指定せずに構築された場合、このプロパティは、この SharedArrayBuffer の byteLength 値に等しい値を返します。
例
これらの例は、コンソールや任意のウェブページから直接実行することはできません。SharedArrayBuffer は、そのセキュリティ要件が満たされない限り定義されないからです。
maxByteLength の使用
この例では、 8 バイトのバッファーを作成し、最大 16 バイトまで伸縮可能であるようにします。そして、その maxByteLength を返します。
js
const buffer = new SharedArrayBuffer(8, { maxByteLength: 16 });
buffer.maxByteLength; // 16
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification> # sec-get-sharedarraybuffer.prototype.maxbytelength> |