CKTIS / JavaScript
Int8Array: interi con segno a 8 bit
Int8Array memorizza numeri come interi con segno a 8 bit da -128 a 127, con un byte per elemento.
Versione: ECMAScript 2015 onward; example target: Node.js 24.22.2
Sintassi
new Int8Array(); new Int8Array(length); new Int8Array(source); new Int8Array(buffer[, byteOffset[, length]])new Int8Array(source?, byteOffset?, length?) crea un typed array numerico da lunghezza, iterable/array-like, altro typed array numerico o ArrayBuffer/SharedArrayBuffer. La forma con buffer condivide i byte senza copia. Ogni byteOffset intero è allineato per un elemento di un byte e BYTES_PER_ELEMENT vale 1.
L’assegnazione applica ToNumber, tronca la frazione, riduce modulo 2^8 e interpreta il risultato con segno. Quindi 128 diventa -128, 255 diventa -1, e NaN e infiniti diventano 0. Assegnare BigInt o usare un typed array BigInt come sorgente genera TypeError. L’ordine dei byte è irrilevante per un solo byte.
La lunghezza passa per ToIndex: le frazioni sono troncate, NaN/undefined diventano 0 e -0.5 dà 0. Risultato negativo dopo ToIntegerOrInfinity, infinito o intervallo fuori buffer genera RangeError; buffer scollegato genera TypeError. Il tipo è standard da ECMAScript 2015.
Esempi
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); }Risultato
127,-128,-1,127,3,0,0 1 2 0 1 2 -5,120 true