CKTIS / JavaScript
TypedArray.byteLength — longueur de la vue en octets
La propriété byteLength indique le nombre d’octets couverts par une vue de tableau typé, et non son nombre d’éléments ni la taille de son tampon entier. Elle se lit sur une instance et n’a pas de setter.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
typedArray.byteLengthTypedArray.byteLength désigne ici la propriété d’instance, formellement nommée TypedArray.prototype.byteLength. Lisez-la sous la forme typedArray.byteLength, sans parenthèses. TypedArray n’est pas un constructeur global ; utilisez un type concret comme Uint16Array. Cette propriété n’a pas de setter : lui affecter une valeur ne redimensionne pas la vue.
length compte les éléments, tandis que byteLength compte les octets : typedArray.byteLength === typedArray.length * typedArray.BYTES_PER_ELEMENT. En revanche, typedArray.buffer.byteLength décrit le tampon entier, et byteOffset indique le début de la vue en octets. Une vue peut ne couvrir qu’une partie d’un tampon ; son byteLength ne mesure pas l’utilisation totale de mémoire de l’objet.
Pour un tampon redimensionnable, le byteLength d’une vue dont la longueur suit celle du tampon peut changer. Une vue de longueur fixe ne s’agrandit pas avec le tampon. Si la réduction du tampon rend la plage de la vue invalide, byteLength vaut 0.
La propriété de base est largement disponible dans les navigateurs depuis juillet 2015 ; la prise en charge des tampons redimensionnables doit être vérifiée séparément. Dans l’exemple, le troisième argument de Uint16Array désigne 3 éléments, et non 3 octets : la vue couvre 6 octets dans un tampon de 16 octets.
Exemples
const buffer = new ArrayBuffer(16);
const view = new Uint16Array(buffer, 4, 3);
console.log(view.length);
console.log(view.BYTES_PER_ELEMENT);
console.log(view.byteLength);
console.log(view.byteOffset);
console.log(view.buffer.byteLength);Résultat
3 2 6 4 16
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.