Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

TypedArray.length — nombre d’éléments d’une vue

TypedArray.length indique le nombre d’éléments d’un tableau typé, et non son nombre d’octets. Lisez cette valeur sur une instance, par exemple avec values.length ; elle ne permet pas de redimensionner la vue.

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.length

TypedArray.length désigne ici la propriété d’instance documentée sous le nom TypedArray.prototype.length. Lisez-la avec typedArray.length, sans parenthèses d’appel. TypedArray est l’abstraction commune aux types concrets tels que Uint16Array, et non un constructeur global utilisable directement.

length compte les éléments de la vue. byteLength compte les octets de cette vue, tandis que buffer.byteLength décrit le tampon entier. Chaque élément d’un Uint16Array occupe 2 octets : une vue dont la length vaut 3 a donc une byteLength de 6. Une vue peut ne couvrir qu’une partie de son tampon. Dans le constructeur, byteOffset s’exprime en octets et length en éléments.

Cette propriété est un accesseur sans setter : affecter une valeur à length ne redimensionne pas un tableau typé. Toutefois, avec un tampon redimensionnable, la length d’une vue qui suit la longueur peut évoluer avec le tampon. Si la réduction du tampon rend la plage de la vue invalide, la lecture de la propriété renvoie 0, y compris pour une vue de longueur fixe. Vérifiez séparément la prise en charge des tampons redimensionnables ; l’accès à length seul ne permet pas de l’établir.

Exemples

const buffer = new ArrayBuffer(12);
const values = new Uint16Array(buffer, 2, 3);

console.log(values.length);
console.log(values.byteLength);
console.log(buffer.byteLength);

Résultat

3
6
12

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.

Sources