Int16Array
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).
Constructor
Int16Array()-
Creates a new
Int16Arrayobject.
Static properties
Int16Array.BYTES_PER_ELEMENT-
Returns a number value of the element size.
2in the case of anInt16Array. Int16Array.name-
Returns the string value of the constructor name. In the case of the
Int16Arraytype: "Int16Array".
Static methods
Int16Array.from()-
Creates a new
Int16Arrayfrom an array-like or iterable object. See alsoArray.from(). Int16Array.of()-
Creates a new
Int16Arraywith a variable number of arguments. See alsoArray.of().
Instance properties
Int16Array.prototype.buffer-
Returns the
ArrayBufferreferenced by theInt16Array. Fixed at construction time and thus read only. Int16Array.prototype.byteLength-
Returns the length (in bytes) of the
Int16Arrayfrom the start of itsArrayBuffer. Fixed at construction time and thus read only. Int16Array.prototype.byteOffset-
Returns the offset (in bytes) of the
Int16Arrayfrom the start of itsArrayBuffer. Fixed at construction time and thus read only. Int16Array.prototype.length-
Returns the number of elements held in the
Int16Array. Fixed at construction time and thus read only.
Instance methods
Int16Array.prototype.copyWithin()-
Copies a sequence of array elements within the array. See also
Array.prototype.copyWithin(). Int16Array.prototype.entries()-
Returns a new array iterator object that contains the key/value pairs for each index in the array. See also
Array.prototype.entries(). Int16Array.prototype.every()-
Tests whether all elements in the array pass the test provided by a function. See also
Array.prototype.every(). Int16Array.prototype.fill()-
Fills all the elements of an array from a start index to an end index with a static value. See also
Array.prototype.fill(). Int16Array.prototype.filter()-
Creates a new array with all of the elements of this array for which the provided filtering function returns
true. See alsoArray.prototype.filter(). Int16Array.prototype.find()-
Returns the found value in the array, if an element in the array satisfies the provided testing function or
undefinedif not found. See alsoArray.prototype.find(). Int16Array.prototype.findIndex()-
Returns the found index in the array, if an element in the array satisfies the provided testing function or
-1if not found. See alsoArray.prototype.findIndex(). Int16Array.prototype.forEach()-
Calls a function for each element in the array. See also
Array.prototype.forEach(). Int16Array.prototype.includes()-
Determines whether a typed array includes a certain element, returning
trueorfalseas appropriate. See alsoArray.prototype.includes(). Int16Array.prototype.indexOf()-
Returns the first (least) index of an element within the array equal to the specified value, or
-1if none is found. See alsoArray.prototype.indexOf(). Int16Array.prototype.join()-
Joins all elements of an array into a string. See also
Array.prototype.join(). Int16Array.prototype.keys()-
Returns a new array iterator that contains the keys for each index in the array. See also
Array.prototype.keys(). Int16Array.prototype.lastIndexOf()-
Returns the last (greatest) index of an element within the array equal to the specified value, or
-1if none is found. See alsoArray.prototype.lastIndexOf(). Int16Array.prototype.map()-
Creates a new array with the results of calling a provided function on every element in this array. See also
Array.prototype.map(). Int16Array.prototype.reduce()-
Apply a function against an accumulator and each value of the array (from left-to-right) as to reduce it to a single value. See also
Array.prototype.reduce(). Int16Array.prototype.reduceRight()-
Apply a function against an accumulator and each value of the array (from right-to-left) as to reduce it to a single value. See also
Array.prototype.reduceRight(). Int16Array.prototype.reverse()-
Reverses the order of the elements of an array — the first becomes the last, and the last becomes the first. See also
Array.prototype.reverse(). Int16Array.prototype.set()-
Stores multiple values in the typed array, reading input values from a specified array.
Int16Array.prototype.slice()-
Extracts a section of an array and returns a new array. See also
Array.prototype.slice(). Int16Array.prototype.some()-
Returns
trueif at least one element in this array satisfies the provided testing function. See alsoArray.prototype.some(). Int16Array.prototype.sort()-
Sorts the elements of an array in place and returns the array. See also
Array.prototype.sort(). Int16Array.prototype.subarray()-
Returns a new
Int16Arrayfrom the given start and end element index. Int16Array.prototype.values()-
Returns a new array iterator object that contains the values for each index in the array. See also
Array.prototype.values(). Int16Array.prototype.toLocaleString()-
Returns a localized string representing the array and its elements. See also
Array.prototype.toLocaleString(). Int16Array.prototype.toString()-
Returns a string representing the array and its elements. See also
Array.prototype.toString(). Int16Array.prototype[@@iterator]()-
Returns a new array iterator object that contains the values for each index in the array.
Examples
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]
Specifications
| Specification |
|---|
| ECMAScript Language Specification (ECMAScript) # table-49 |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
Int16Array |
7 |
12 |
4 |
10 |
11.6 |
5.1 |
4 |
18 |
4 |
12 |
4.2 |
1.0 |
Int16Array |
7 |
12 |
4 |
10 |
11.6 |
5.1 |
4 |
18 |
4 |
12 |
4.2 |
1.0 |
See also
- A polyfill of
Int16Arrayis available incore-js - JavaScript typed arrays
ArrayBufferDataView
© 2005–2021 MDN 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