The Int16Array
typed array represents an array of twos-complement 16-bit signed integers in the platform byte order. If control over byte order is needed, use DataView
instead. The contents are initialized to 0
. 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).
new Int16Array(); // new in ES2017 new Int16Array(length); new Int16Array(typedArray); new Int16Array(object); new Int16Array(buffer [, byteOffset [, length]]);
For more information about the constructor syntax and the parameters, see TypedArray.
Int16Array.BYTES_PER_ELEMENT
2
in the case of an Int16Array
.Int16Array.prototype.length
.Int16Array.name
Int16Array
type: "Int16Array".Int16Array.prototype
Int16Array.from()
Int16Array
from an array-like or iterable object. See also Array.from()
.Int16Array.of()
Int16Array
with a variable number of arguments. See also Array.of()
.Int16Array
prototypeAll Int16Array
objects inherit from %TypedArray%.prototype
.
Int16Array.prototype.constructor
Int16Array
constructor by default.Int16Array.prototype.buffer
Read only
ArrayBuffer
referenced by the Int16Array
Fixed at construction time and thus read only.Int16Array.prototype.byteLength
Read only
Int16Array
from the start of its ArrayBuffer
. Fixed at construction time and thus read only.
Int16Array.prototype.byteOffset
Read only
Int16Array
from the start of its ArrayBuffer
. Fixed at construction time and thus read only.
Int16Array.prototype.length
Read only
Int16Array
. Fixed at construction time and thus read only.
Int16Array.prototype.copyWithin()
Array.prototype.copyWithin()
.Int16Array.prototype.entries()
Array Iterator
object that contains the key/value pairs for each index in the array. See also Array.prototype.entries()
.Int16Array.prototype.every()
Array.prototype.every()
.Int16Array.prototype.fill()
Array.prototype.fill()
.Int16Array.prototype.filter()
Array.prototype.filter()
.Int16Array.prototype.find()
undefined
if not found. See also Array.prototype.find()
.Int16Array.prototype.findIndex()
Array.prototype.findIndex()
.Int16Array.prototype.forEach()
Array.prototype.forEach()
.Int16Array.prototype.includes()
true
or false
as appropriate. See also Array.prototype.includes()
.Int16Array.prototype.indexOf()
Array.prototype.indexOf()
.Int16Array.prototype.join()
Array.prototype.join()
.Int16Array.prototype.keys()
Array Iterator
that contains the keys for each index in the array. See also Array.prototype.keys()
.Int16Array.prototype.lastIndexOf()
Array.prototype.lastIndexOf()
.Int16Array.prototype.map()
Array.prototype.map()
.Int16Array.prototype.move()
Unimplemented
Int16Array.prototype.copyWithin()
.Int16Array.prototype.reduce()
Array.prototype.reduce()
.Int16Array.prototype.reduceRight()
Array.prototype.reduceRight()
.Int16Array.prototype.reverse()
Array.prototype.reverse()
.Int16Array.prototype.set()
Int16Array.prototype.slice()
Array.prototype.slice()
.Int16Array.prototype.some()
Array.prototype.some()
.Int16Array.prototype.sort()
Array.prototype.sort()
.Int16Array.prototype.subarray()
Int16Array
from the given start and end element index.Int16Array.prototype.values()
Array Iterator
object that contains the values for each index in the array. See also Array.prototype.values()
.Int16Array.prototype.toLocaleString()
Array.prototype.toLocaleString()
.Int16Array.prototype.toString()
Array.prototype.toString()
.Int16Array.prototype[@@iterator]()
Array Iterator
object that contains the values for each index in the array.Different ways to create an Int16Array
:
// From a length var int16 = new Int16Array(2); int16[0] = 42; console.log(int16[0]); // 42 console.log(int16.length); // 2 console.log(int16.BYTES_PER_ELEMENT); // 2 // From an array var arr = new Int16Array([21,31]); console.log(arr[1]); // 31 // From another TypedArray var x = new Int16Array([21, 31]); var y = new Int16Array(x); console.log(y[0]); // 21 // From an ArrayBuffer var buffer = new ArrayBuffer(8); var z = new Int16Array(buffer, 0, 4); // From an iterable var iterable = function*(){ yield* [1,2,3]; }(); var int16 = new Int16Array(iterable); // Int16Array[1, 2, 3]
Specification | Status | Comment |
---|---|---|
Typed Array Specification | Obsolete | Superseded by ECMAScript 2015. |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'TypedArray constructors' in that specification. | Standard | Initial definition in an ECMA standard. Specified that new is required. |
ECMAScript Latest Draft (ECMA-262) The definition of 'TypedArray constructors' in that specification. | Living Standard | ECMAScript 2017 changed the Int16Array constructor to use the ToIndex operation and allows constructors with no arguments. |
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | 7 | Yes | 4 | 10 | 11.6 | 5.1 |
Int16Array() without new throws |
Yes | Yes | 44 | No | Yes | ? |
Iterable in constructor | ? | ? | 52 | ? | ? | ? |
Constructor without arguments | ? | ? | 55 | ? | ? | ? |
Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic support | 4 | Yes | Yes | 4 | 10 | 11.6 | 4.2 |
Int16Array() without new throws |
? | ? | ? | 44 | ? | ? | ? |
Iterable in constructor | ? | ? | ? | 52 | ? | ? | ? |
Constructor without arguments | ? | ? | ? | 55 | ? | ? | ? |
Starting with ECMAScript 2015, Int16Array
constructors require to be constructed with a new
operator. Calling a Int16Array
constructor as a function without new
, will throw a TypeError
from now on.
var dv = Int16Array([1, 2, 3]); // TypeError: calling a builtin Int16Array constructor // without new is forbidden
var dv = new Int16Array([1, 2, 3]);
© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Int16Array