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

CKTIS / JavaScript

Uint16Array — tableau typé non signé sur 16 bits

Uint16Array est une vue typée sur un tampon qui stocke des entiers de 0 à 65535, à raison de 2 octets par élément. Découvrez la conversion des valeurs et la différence entre copier les données et partager une 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

new Uint16Array(length)
new Uint16Array(iterableOrArrayLike)
new Uint16Array(typedArray)
new Uint16Array(buffer, byteOffset?, length?)

Uint16Array est un tableau typé intégré à ECMAScript, et non un Array ordinaire. Chaque élément occupe 2 octets et est renvoyé à la lecture sous la forme d’un Number compris entre 0 et 65535. length indique le nombre d’éléments, byteLength le nombre d’octets de la vue, et Uint16Array.BYTES_PER_ELEMENT vaut 2.

Le constructeur exige new. Si l’argument est numérique, le constructeur utilise ToIndex pour déterminer le nombre d’éléments initialisés à zéro. Par exemple, new Uint16Array(3.9) crée trois éléments, tandis que new Uint16Array(-1) lève une exception RangeError. Une collection fournit les valeurs à copier. La variante avec ArrayBuffer crée une vue sans copier : byteOffset est exprimé en octets et doit être un multiple de 2, tandis que length, facultatif, compte les éléments et non les octets.

Lors d’une écriture, les valeurs sont converties plutôt que vérifiées par rapport à leur plage : les valeurs Number finies sont tronquées vers zéro, puis réduites modulo 65536. Ainsi, 65536 devient 0, -1 devient 65535 et 3.9 devient 3. NaN et les infinis deviennent 0 ; les valeurs BigInt provoquent une TypeError. Il ne s’agit pas d’un écrêtage.

subarray() partage le stockage avec l’original, tandis que slice() copie les données. L’exemple illustre la conversion et la modification de l’original par l’intermédiaire d’une vue. L’ordre des octets dépend de l’implémentation ; utilisez DataView pour un format binaire dont l’ordre des octets est explicite.

Exemples

const values = new Uint16Array([65535, 65536, -1, 3.9]);
const view = values.subarray(1, 3);
view[0] = 42;
console.log(values.join(","));
console.log(`${values.length} ${values.byteLength} ${Uint16Array.BYTES_PER_ELEMENT}`);

Résultat

65535,42,65535,3
4 8 2

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