[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/resize [Back]  [Original]

ArrayBuffer : mthode resize() - JavaScript | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

ArrayBuffer : mthode resize()

Baseline 2024
Nouvellement disponible

Depuis juillet 2024, cette fonctionnalit fonctionne sur les appareils et les versions de navigateur les plus rcents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

La mthode resize() des instances de ArrayBuffer redimensionne un ArrayBuffer la taille dfinie, en octets.

Dans cet article

Exemple interactif

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

console.log(buffer.byteLength);
// Rsultat attendu : 8

buffer.resize(12);

console.log(buffer.byteLength);
// Rsultat attendu : 12

Syntaxe

js
resize(newLength)

Paramtres

newLength

La nouvelle taille, en octets, laquelle redimensionner ArrayBuffer.

Valeur de retour

Aucune (undefined).

Exceptions

TypeError

Leve si ArrayBuffer est dtach ou n'est pas redimensionnable.

RangeError

Leve si newLength est suprieur la proprit maxByteLength de ArrayBuffer.

Description

La mthode resize() redimensionne un ArrayBuffer la taille dfinie par le paramtre newLength, condition que l'ArrayBuffer soit redimensionnable et que la nouvelle taille soit infrieure ou gale la proprit maxByteLength de l'ArrayBuffer. Les nouveaux octets sont initialiss 0.

Vous pouvez utiliser resize() pour rduire ou agrandir un ArrayBuffer : il est permis que newLength soit infrieur la proprit byteLength actuelle de l'ArrayBuffer.

Exemples

Utiliser resize()

Dans cet exemple, on cre un tampon de 8 octets qui peut tre redimensionn jusqu' une taille maximale de 16 octets, puis on vrifie sa proprit 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);
}

Spcifications

Spcification
ECMAScript 2027 LanguageSpecification
# sec-arraybuffer.prototype.resize

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page