Knowledge baseExam Center
ENEnglish
Choose language13

CKTIS / JavaScript

Int16Array: signed 16-bit integers

Int16Array stores numbers as signed 16-bit integers from -32768 through 32767, using 2 bytes per element.

Version: ECMAScript 2015 onward; example target: Node.js 24.22.2

Syntax

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

new Int16Array(source?, byteOffset?, length?) creates a numeric typed array from a length, iterable/array-like value, another numeric typed array, or an ArrayBuffer/SharedArrayBuffer. The buffer form does not copy bytes, byteOffset must be a multiple of 2, and BYTES_PER_ELEMENT is 2.

Assignment applies ToNumber, truncates the fractional part, reduces modulo 2^16, then interprets the result as signed. Thus 32768 becomes -32768, 65535 becomes -1, and NaN and infinities become 0. Assigning a BigInt or using a BigInt typed array as source throws TypeError. Byte order is native; use DataView for explicit endianness.

Length goes through ToIndex: fractions truncate, NaN/undefined become 0, and -0.5 gives 0. A negative result after ToIntegerOrInfinity, infinity, a misaligned offset, or a range beyond the buffer throws RangeError; a detached buffer throws TypeError. The type has been standard since ECMAScript 2015.

Examples

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); }

Result

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

Sources