Int8Array
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
TheInt8Array
typed array represents an array of 8-bit signed integers. The contents are initialized to0
unless initialization data is explicitly provided. Once established, you can reference elements in the array using the object's methods, or using standard array index syntax (that is, using bracket notation).
Int8Array
is a subclass of the hiddenTypedArray
class.
Constructor
Int8Array()
Creates a new
Int8Array
object.
Static properties
Also inherits static properties from its parentTypedArray
.
Int8Array.BYTES_PER_ELEMENT
Returns a number value of the element size.
1
in the case ofInt8Array
.
Static methods
Inherits static methods from its parentTypedArray
.
Instance properties
Also inherits instance properties from its parentTypedArray
.
These properties are defined onInt8Array.prototype
and shared by allInt8Array
instances.
Int8Array.prototype.BYTES_PER_ELEMENT
Returns a number value of the element size.
1
in the case of aInt8Array
.Int8Array.prototype.constructor
The constructor function that created the instance object. For
Int8Array
instances, the initial value is theInt8Array
constructor.
Instance methods
Inherits instance methods from its parentTypedArray
.
Examples
Different ways to create an Int8Array
// From a lengthconst int8 = new Int8Array(2);int8[0] = 42;console.log(int8[0]); // 42console.log(int8.length); // 2console.log(int8.BYTES_PER_ELEMENT); // 1// From an arrayconst x = new Int8Array([21, 31]);console.log(x[1]); // 31// From another TypedArrayconst y = new Int8Array(x);console.log(y[0]); // 21// From an ArrayBufferconst buffer = new ArrayBuffer(8);const z = new Int8Array(buffer, 1, 4);console.log(z.byteOffset); // 1// From an iterableconst iterable = (function* () { yield* [1, 2, 3];})();const int8FromIterable = new Int8Array(iterable);console.log(int8FromIterable);// Int8Array [1, 2, 3]
Specifications
Specification |
---|
ECMAScript® 2026 Language Specification # sec-typedarray-objects |