CKTIS / JavaScript
Int8Array : entiers signés sur 8 bits
Int8Array stocke les nombres comme entiers signés sur 8 bits de -128 à 127, avec un octet par élément.
Version : ECMAScript 2015 onward; example target: Node.js 24.22.2
Syntaxe
new Int8Array(); new Int8Array(length); new Int8Array(source); new Int8Array(buffer[, byteOffset[, length]])new Int8Array(source?, byteOffset?, length?) crée un typed array numérique depuis une longueur, un itérable/array-like, un autre typed array numérique ou un ArrayBuffer/SharedArrayBuffer. La forme tampon partage les octets sans copie. Tout byteOffset entier est aligné pour un élément d’un octet et BYTES_PER_ELEMENT vaut 1.
L’affectation applique ToNumber, tronque la fraction, réduit modulo 2^8, puis interprète avec signe. Ainsi 128 devient -128, 255 devient -1, et NaN comme les infinis deviennent 0. Affecter un BigInt ou fournir un typed array BigInt lève TypeError. L’ordre des octets est sans effet pour un seul octet.
La longueur passe par ToIndex : les fractions sont tronquées, NaN/undefined deviennent 0 et -0.5 donne 0. Résultat négatif après ToIntegerOrInfinity, infinité ou plage hors tampon lève RangeError ; tampon détaché lève TypeError. Le type est standard depuis ECMAScript 2015.
Exemples
const values = new Int8Array([127, 128, 255, -129, 3.9, NaN, Infinity]);
console.log(Array.from(values).join(","));
console.log(Int8Array.BYTES_PER_ELEMENT, new Int8Array(2.9).length, new Int8Array(-0.5).length);
const buffer = new ArrayBuffer(4);
const view = new Int8Array(buffer, 1, 2);
view.set([-5, 120]);
console.log(view.byteOffset, view.byteLength, Array.from(view).join(","));
try { view[0] = 1n; } catch (error) { console.log(error instanceof TypeError); }Résultat
127,-128,-1,127,3,0,0 1 2 0 1 2 -5,120 true