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

CKTIS / JavaScript

Int16Array: enteros con signo de 16 bits

Int16Array almacena números como enteros con signo de 16 bits entre -32768 y 32767, con 2 bytes por elemento.

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

Sintaxis

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

new Int16Array(source?, byteOffset?, length?) crea un typed array numérico desde una longitud, iterable/array-like, otro typed array numérico o ArrayBuffer/SharedArrayBuffer. La forma con búfer no copia bytes, byteOffset debe ser múltiplo de 2 y BYTES_PER_ELEMENT vale 2.

La asignación aplica ToNumber, trunca la fracción, reduce módulo 2^16 e interpreta el resultado con signo. Así 32768 se vuelve -32768, 65535 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 es nativo; usa DataView para endianness explícito.

La longitud pasa por ToIndex: las fracciones se truncan, NaN/undefined se vuelven 0 y -0.5 da 0. Resultado negativo tras ToIntegerOrInfinity, infinito, offset desalineado 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 Int16Array([32767, 32768, 65535, -32769, 3.9, NaN, Infinity]);
console.log(Array.from(values).join(","));
console.log(Int16Array.BYTES_PER_ELEMENT, new Int16Array(2.9).length, new Int16Array(-0.5).length);

const buffer = new ArrayBuffer(6);
const view = new Int16Array(buffer, 2, 1);
view[0] = -1234;
console.log(view.byteOffset, view.byteLength, view[0]);
try { view[0] = 1n; } catch (error) { console.log(error instanceof TypeError); }

Resultado

32767,-32768,-1,32767,3,0,0
2 2 0
2 2 -1234
true

Fuentes