Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Int8Array: enteros con signo de 8 bits

Int8Array almacena números como enteros con signo de 8 bits entre -128 y 127, con un byte por elemento.

Versión: ECMAScript 2015 onward; example target: Node.js 24.22.2

Sintaxis

new Int8Array(); new Int8Array(length); new Int8Array(source); new Int8Array(buffer[, byteOffset[, length]])

new Int8Array(source?, byteOffset?, length?) crea un typed array numérico desde longitud, iterable/array-like, otro typed array numérico o ArrayBuffer/SharedArrayBuffer. La forma con búfer comparte bytes sin copia. Todo byteOffset entero está alineado para un elemento de un byte y BYTES_PER_ELEMENT vale 1.

La asignación aplica ToNumber, trunca la fracción, reduce módulo 2^8 e interpreta el resultado con signo. Así 128 se vuelve -128, 255 se vuelve -1, y NaN e infinitos se vuelven 0. Asignar BigInt o usar un typed array BigInt como origen lanza TypeError. El orden de bytes no importa para un solo byte.

La longitud pasa por ToIndex: las fracciones se truncan, NaN/undefined se vuelven 0 y -0.5 da 0. Resultado negativo tras ToIntegerOrInfinity, infinito o rango fuera del búfer lanza RangeError; búfer separado lanza TypeError. El tipo es estándar desde ECMAScript 2015.

Ejemplos

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

Fuentes