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.
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
maxByteLength
は ArrayBuffer
インスタンスのアクセサープロパティで、ArrayBuffer
がサイズ変更可能な最大長をバイト数で表します。
試してみましょう
解説
maxByteLength
プロパティはアクセサープロパティであり、その設定アクセサー関数が undefined
であるため、このプロパティは読み取ることしかできません。この値は配列の構築時に、 maxByteLength
オプションを ArrayBuffer()
コンストラクターで設定した際に設定され、変更することができません。
このプロパティは、この ArrayBuffer
が切り離されている場合は 0 を返し ます。この ArrayBuffer
が maxByteLength
の値を指定せずに構築された場合、このプロパティは ArrayBuffer
の byteLength
の値と等しい値を返します。
例
maxByteLength の使用
この例では、最大 16 バイトまでサイズ変更可能な 8 バイトのバッファーが作成され、そのmaxByteLength
を返しています。
const buffer = new ArrayBuffer(8, { maxByteLength: 16 });
buffer.maxByteLength; // 16
仕様書
Specification |
---|
ECMAScript Language Specification # sec-get-arraybuffer.prototype.maxbytelength |
ブラウザーの互換性
BCD tables only load in the browser