JavaScript Typed Array Reference
JavaScript Typed Arrays
A typed array is an array-like buffer for storing raw binary data.
See Also:
Typed Array Types
| Name | Range | Type |
|---|---|---|
| Int8Array | -128 / 127 | Signed integer (1 byte) |
| Uint8Array | 0 / 255 | Unsigned integer (1 byte) |
| Uint8ClampedArray | 0 / 255 | Unsigned integer (1 byte) |
| Int16Array | -32768 / 32767 | Signed short (2 bytes) |
| Uint16Array | 0 / 65535 | Unsigned short (2 bytes) |
| Int32Array | -231 / 231 - 1 | Signed long (4 bytes) |
| Uint32Array | 0 / 232 - 1 | Unsigned long (4 bytes) |
| BigInt64Array | -263 / 263 - 1 | Signed big integer (8 bytes) |
| BigUint64Array | 0 / 264 - 1 | Unsigned big integer (8 bytes) |
| Float16Array | -65504 / 65504 | floating point (2 bytes) |
| Float32Array | -3.4e38 / 3.4e38 | floating point (4 bytes) |
| Float64Array | -1.8e308 / 1.8e308 | floating point (8 bytes) |
Note
Typed arrays are not arrays.
isArray() on a typed array returns false.
Typed Array Methods and Properties
| Method / Property | Description | Try it |
|---|---|---|
| BYTES_PER_ELEMENT | Property to count the number of bytes used to store one element | Try it » |
| fill() | Fill all elements with a value | Try it » |
| find() | Returns the first element that satisfies a condition | Try it » |
| name | Returns the name of the typed array | Try it » |
| of() | Method to create a typed array from an array | Try it » |
| some() | Reurns true if one element satisfies a condition | Try it » |
Typed Array Benefits
Typed arrays provide a way to handle binary data as efficiently as arrays work in C.
Typed arrays are raw memory, so JavaScript can pass them directly to any function without converting the data to another representation.
Typed arrays are seriously faster than normal arrays for passing data to functions that can use raw binary data (Computer Games, WebGL, Canvas, File APIs, Media APIs).
Browser APIs Supporting Typed Arrays
Fetch API Example
fetch(url)
.then(request => request.arrayBuffer())
.then(arrayBuffer =>...);
Canvas Example
const canvas = document.getElementById('my_canvas');
const context = canvas.getContext('2d');
const imageData = context.getImageData(0, 0, canvas.width, canvas.height);
const uint8ClampedArray = imageData.data;
Browser Support
Typed Array is an ECMAScript6 (ES6) feature.
ES6 (JavaScript 2015) is supported in all modern browsers since June 2017:
| Chrome 51 | Edge 15 | Firefox 54 | Safari 10 | Opera 38 |
| May 2016 | Apr 2017 | Jun 2017 | Sep 2016 | Jun 2016 |
Typed Array is not supported in Internet Explorer.
