ArrayBuffer : méthode resize()

Baseline 2024

Nouvellement disponible

Depuis July 2024, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

La méthode resize() des instances de ArrayBuffer redimensionne un ArrayBuffer à la taille définie, en octets.

Dans cet article

Exemple interactif

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

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

buffer.resize(12);

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

Syntaxe

resize(newLength)

Paramètres

newLength

La nouvelle taille, en octets, à laquelle redimensionner ArrayBuffer.

Exceptions

TypeError

Levée si ArrayBuffer est détaché ou n'est pas redimensionnable.

RangeError

Levée si newLength est supérieur à la propriété maxByteLength de ArrayBuffer.

La méthode resize() redimensionne un ArrayBuffer à la taille définie par le paramètre newLength, à condition que l'ArrayBuffer soit redimensionnable et que la nouvelle taille soit inférieure ou égale à la propriété maxByteLength de l'ArrayBuffer. Les nouveaux octets sont initialisés à 0.

Vous pouvez utiliser resize() pour réduire ou agrandir un ArrayBuffer : il est permis que newLength soit inférieur à la propriété byteLength actuelle de l'ArrayBuffer.

Exemples

Utiliser resize()

Dans cet exemple, on crée un tampon de 8 octets qui peut être redimensionné jusqu'à une taille maximale de 16 octets, puis on vérifie sa propriété resizable et on le redimensionne si resizable retourne true :

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

if (buffer.resizable) {
  console.log("Le tampon est redimensionnable !");
  buffer.resize(12);
}