ArrayBuffer : méthode resize()

Baseline 2024

Newly available

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éthoderesize() des instances deArrayBuffer redimensionne unArrayBuffer à la taille définie, en octets.

Exemple interactif

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });console.log(buffer.byteLength);// Résultat attendu : 8buffer.resize(12);console.log(buffer.byteLength);// Résultat attendu : 12

Syntaxe

resize(newLength)

Paramètres

newLength: La nouvelle taille, en octets, à laquelle redimensionnerArrayBuffer.

Exceptions

TypeError: Levée siArrayBuffer est détaché ou n'est pas redimensionnable.
RangeError: Levée sinewLength est supérieur à la propriétémaxByteLength deArrayBuffer.

La méthoderesize() redimensionne unArrayBuffer à la taille définie par le paramètrenewLength, à condition que l'ArrayBuffer soitredimensionnable 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 utiliserresize() pour réduire ou agrandir unArrayBuffer : il est permis quenewLength 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 siresizable retournetrue :

const buffer = new ArrayBuffer(8, { maxByteLength: 16 });if (buffer.resizable) {  console.log("Le tampon est redimensionnable !");  buffer.resize(12);}