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.