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

CKTIS / JavaScript

Uint8Array — une vue d’octets non signés

Uint8Array expose les données d’un tampon sous forme d’entiers non signés sur 8 bits, compris entre 0 et 255. Il permet de créer et de copier des octets ou de partager la mémoire par l’intermédiaire de vues ; les écritures hors plage reviennent dans l’intervalle au lieu d’être plafonnées.

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 Uint8Array(length)
new Uint8Array(values)
new Uint8Array(buffer[, byteOffset[, length]])

Uint8Array est un tableau typé : une vue sur un tampon dont chaque élément occupe un octet et est lu comme une valeur Number comprise entre 0 et 255. Ce n’est pas un Array ordinaire. La propriété length indique le nombre d’éléments, byteLength la taille de la vue en octets, et buffer donne accès au tampon sous-jacent.

new Uint8Array(length) crée un tampon rempli de zéros. new Uint8Array(values) copie les valeurs d’un objet itérable ou semblable à un tableau. new Uint8Array(buffer, byteOffset, length) crée une vue sur un tampon existant sans effectuer de copie ; byteOffset est un décalage en octets et length indique le nombre d’éléments. Le constructeur doit être appelé avec new.

Lors d’une affectation, les nombres finis sont tronqués vers zéro, puis réduits modulo 256 : 256 devient 0 et -1 devient 255. NaN et les infinis deviennent 0. Il ne s’agit ni d’une validation de plage ni d’un plafonnement comme avec Uint8ClampedArray ; vérifiez les données invalides avant de les écrire.

subarray() crée une vue qui partage la mémoire, tandis que slice() crée une copie indépendante. Dans l’exemple, modifier view[0] modifie aussi bytes[1], mais ne change pas copy. Cette entrée couvre les opérations fondamentales d’ECMAScript, et non les méthodes d’encodage plus récentes. La spécification, à elle seule, ne prouve pas la compatibilité avec un navigateur particulier ; la présence de Node 24 dans un dépôt ne la prouve pas non plus.

Exemples

const bytes = new Uint8Array([0, 255, 256, -1]);
const view = bytes.subarray(1, 3);
const copy = bytes.slice(1, 3);
view[0] = 42;
console.log(bytes.join(','));
console.log(copy.join(','));
console.log(bytes.length + ':' + bytes.byteLength);

Résultat

0,42,0,255
255,0
4: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