title: Int32Array
slug: Web/JavaScript/Reference/Global_Objects/Int32Array
page-type: javascript-class
browser-compat: javascript.builtins.Int32Array
sidebar: jsref
The Int32Array typed array represents an array of 32-bit signed integers in the platform byte order. If control over byte order is needed, use {{jsxref("DataView")}} instead. The contents are initialized to 0 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).
Int32Array is a subclass of the hidden {{jsxref("TypedArray")}} class.
Constructor
- {{jsxref("Int32Array/Int32Array", "Int32Array()")}}
- : Creates a new
Int32Arrayobject.
- : Creates a new
Static properties
Also inherits static properties from its parent {{jsxref("TypedArray")}}.
- {{jsxref("TypedArray/BYTES_PER_ELEMENT", "Int32Array.BYTES_PER_ELEMENT")}}
- : Returns a number value of the element size.
4in the case ofInt32Array.
- : Returns a number value of the element size.
Static methods
Inherits static methods from its parent {{jsxref("TypedArray")}}.
Instance properties
Also inherits instance properties from its parent {{jsxref("TypedArray")}}.
These properties are defined on Int32Array.prototype and shared by all Int32Array instances.
- {{jsxref("TypedArray/BYTES_PER_ELEMENT", "Int32Array.prototype.BYTES_PER_ELEMENT")}}
- : Returns a number value of the element size.
4in the case of anInt32Array.
- : Returns a number value of the element size.
- {{jsxref("Object/constructor", "Int32Array.prototype.constructor")}}
- : The constructor function that created the instance object. For
Int32Arrayinstances, the initial value is the {{jsxref("Int32Array/Int32Array", "Int32Array")}} constructor.
- : The constructor function that created the instance object. For
Instance methods
Inherits instance methods from its parent {{jsxref("TypedArray")}}.
Examples
Different ways to create an Int32Array
// From a length
const int32 = new Int32Array(2);
int32[0] = 42;
console.log(int32[0]); // 42
console.log(int32.length); // 2
console.log(int32.BYTES_PER_ELEMENT); // 4
// From an array
const x = new Int32Array([21, 31]);
console.log(x[1]); // 31
// From another TypedArray
const y = new Int32Array(x);
console.log(y[0]); // 21
// From an ArrayBuffer
const buffer = new ArrayBuffer(32);
const z = new Int32Array(buffer, 4, 4);
console.log(z.byteOffset); // 4
// From an iterable
const iterable = (function* () {
yield* [1, 2, 3];
})();
const int32FromIterable = new Int32Array(iterable);
console.log(int32FromIterable);
// Int32Array [1, 2, 3]
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Polyfill of
Int32Arrayincore-js - JavaScript typed arrays guide
- {{jsxref("TypedArray")}}
- {{jsxref("ArrayBuffer")}}
- {{jsxref("DataView")}}