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

CKTIS / JavaScript

TypedArray : tailles, indexation, vues et copies

Découvrez la différence entre le nombre d’éléments et le nombre d’octets dans TypedArray. Voyez comment buffer et byteOffset décrivent une vue, et pourquoi subarray() partage les données tandis que slice() crée une copie indépendante.

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

const view = new Uint16Array(buffer, byteOffset, length);
view.length; view.byteLength; view.buffer; view.byteOffset;
view[index]; view[index] = value;
view.subarray(begin, end);
view.slice(start, end);

TypedArray est l’interface commune des vues typées sur des données binaires, et non un constructeur disponible globalement. Utilisez un type concret comme Uint16Array. Ces API font partie d’ECMAScript et ne nécessitent pas le DOM. Ici, TypedArray.length, TypedArray.byteLength, TypedArray.buffer et TypedArray.byteOffset désignent des propriétés d’instance comme view.length, et non des propriétés statiques.

length compte les éléments, byteLength compte les octets de la vue, buffer référence l’intégralité de l’ArrayBuffer ou du SharedArrayBuffer sous-jacent, et byteOffset indique en octets le début de la vue par rapport au buffer. Pour une vue valide, byteLength === length * BYTES_PER_ELEMENT. Une vue peut ne couvrir qu’une partie de son buffer. Dans new Uint16Array(buffer, byteOffset, length), le décalage doit être un multiple de 2, tandis que length compte toujours les éléments. Ces propriétés sont en lecture seule ; un redimensionnement du buffer peut néanmoins modifier les tailles rapportées, et une vue hors limites rapporte des tailles et un décalage nuls.

TypedArray.indexing désigne la syntaxe view[index], pas une méthode. Les indices commencent à zéro et désignent les éléments à partir du début de la vue. Une affectation convertit la valeur vers le type de l’élément. Une lecture hors limites renvoie undefined ; une écriture hors limites n’agrandit pas la vue et ne stocke aucune valeur. view[-1] ne lit pas le dernier élément.

TypedArray.prototype.subarray(begin, end) crée une nouvelle vue qui partage le buffer : les modifications des éléments communs sont visibles dans les deux vues. TypedArray.prototype.slice(start, end) copie les éléments sélectionnés dans un buffer indépendant. Les deux méthodes expriment les limites en éléments, incluent le début et excluent la fin ; les limites négatives sont comptées depuis la fin, et si la fin est omise, elle correspond à la fin de la vue. Ces règles décrivent les types intégrés ordinaires ; les sous-classes personnalisées peuvent modifier la création des résultats via Symbol.species.

Exemples

const buffer = new ArrayBuffer(12);
const view = new Uint16Array(buffer, 2, 4);
view.set([10, 20, 30, 40]);
const shared = view.subarray(1, 3);
const copied = view.slice(1, 3);
shared[0] = 99;
console.log(view.length, view.byteLength, view.byteOffset, buffer.byteLength);
console.log(shared.byteOffset, shared.buffer === view.buffer, copied.buffer === view.buffer);
console.log(view.join(','));
console.log(shared.join(','));
console.log(copied.join(','));
view[4] = 50;
console.log(view[4], view.length);

Résultat

4 8 2 12
4 true false
10,99,30,40
99,30
20,30
undefined 4

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