Knowledge baseExam Center
ENEnglish
Choose language13

CKTIS / JavaScript

Int8Array: signed 8-bit integers

Int8Array stores numbers as signed 8-bit integers from -128 through 127, using one byte per element.

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

Syntax

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

new Int8Array(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 shares bytes without copying. Every integer byteOffset is aligned for a one-byte element, and BYTES_PER_ELEMENT is 1.

Assignment applies ToNumber, truncates a fraction, reduces modulo 2^8, then interprets the result as signed. Thus 128 becomes -128, 255 becomes -1, and NaN and infinities become 0. Assigning a BigInt or using a BigInt typed array as source throws TypeError. Byte order is irrelevant for a single byte.

Length goes through ToIndex: fractions truncate, NaN/undefined become 0, and -0.5 gives 0. A negative result after ToIntegerOrInfinity, infinity, 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 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); }

Result

127,-128,-1,127,3,0,0
1 2 0
1 2 -5,120
true

Sources