ArrayBuffer : propriété maxByteLength

Exemple interactif

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

console.log(buffer.byteLength);
// Résultat attendu : 8

console.log(buffer.maxByteLength);
// Résultat attendu : 16

Description

La propriété maxByteLength est un accesseur dont le mutateur associé vaut undefined, ce qui signifie que cette propriété est en lecture seule. La valeur est déterminée lors de la construction du tableau, via l'option maxByteLength du constructeur ArrayBuffer(), et ne peut pas être modifiée.

Cette propriété retourne 0 si cet ArrayBuffer a été détaché. Si cet ArrayBuffer a été construit sans valeur maxByteLength définie, cette propriété retourne une valeur égale à celle de la propriété byteLength de l'ArrayBuffer.

Examples

Utiliser maxByteLength

Dans cet exemple, on crée un tampon de 8 octets qui peut être redimensionné jusqu'à une taille maximale de 16 octets, puis on retourne sa propriété maxByteLength :

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

buffer.maxByteLength; // 16

Specifications

Browser compatibility

See also

• L'objet global ArrayBuffer
• La propriété ArrayBuffer.prototype.byteLength
• La méthode ArrayBuffer.prototype.resize()