CKTIS / JavaScript
Int8Array: inteiros com sinal de 8 bits
Int8Array guarda números como inteiros com sinal de 8 bits entre -128 e 127, com um byte por elemento.
Versão: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintaxe
new Int8Array(); new Int8Array(length); new Int8Array(source); new Int8Array(buffer[, byteOffset[, length]])new Int8Array(source?, byteOffset?, length?) cria um typed array numérico a partir de comprimento, iterable/array-like, outro typed array numérico ou ArrayBuffer/SharedArrayBuffer. A forma com buffer partilha bytes sem cópia. Todo byteOffset inteiro está alinhado para um elemento de um byte e BYTES_PER_ELEMENT é 1.
A atribuição aplica ToNumber, trunca a fração, reduz módulo 2^8 e interpreta o resultado com sinal. Assim 128 torna-se -128, 255 torna-se -1, e NaN e infinitos tornam-se 0. Atribuir BigInt ou usar typed array BigInt como origem lança TypeError. A ordem dos bytes é irrelevante para um único byte.
O comprimento passa por ToIndex: frações são truncadas, NaN/undefined tornam-se 0 e -0.5 dá 0. Resultado negativo após ToIntegerOrInfinity, infinito ou intervalo fora do buffer lança RangeError; buffer separado lança TypeError. O tipo é padrão desde ECMAScript 2015.
Exemplos
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); }Resultado
127,-128,-1,127,3,0,0 1 2 0 1 2 -5,120 true