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

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

Sources