{{JSRef("Global_Objects", "TypedArray", "Int8Array,Uint8Array,Uint8ClampedArray,Int16Array,Uint16Array,Int32Array,Uint32Array,Float32Array,Float64Array")}}
Summary
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 {{jsxref("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).
Syntax
Int16Array(length); Int16Array(typedArray); Int16Array(object); Int16Array(buffer [, byteOffset [, length]]);
For more information about the constructor syntax and the parameters, see TypedArray.
Properties
- {{jsxref("TypedArray.BYTES_PER_ELEMENT", "Int16Array.BYTES_PER_ELEMENT")}}
-
Returns a number value of the element size.
2
in the case of anInt16Array
. - Int16Array.length
- Length property whose value is 3.
- {{jsxref("TypedArray.name", "Int16Array.name")}}
-
Returns the string value of the constructor name. In the case of the
Int16Array
type: "Int16Array". - {{jsxref("TypedArray.prototype", "Int16Array.prototype")}}
- Prototype for the TypedArray objects.
Methods
- Int16Array.from()
- See {{jsxref("Array.from()")}}. Not implemented, see {{bug(896608)}}.
- Int16Array.of()
- See {{ jsxref("Array.of()")}}. Not implemented, see {{bug(896608)}}.
Int16Array
prototype
All Int16Array
objects inherit from {{jsxref("TypedArray.prototype", "%TypedArray%.prototype")}}.
Properties
-
Int16Array.prototype.constructor
-
Returns the function that created an instance's prototype. This is the
Int16Array
constructor by default. - {{jsxref("TypedArray.prototype.buffer", "Int16Array.prototype.buffer")}} {{readonlyInline}}
-
Returns the {{jsxref("ArrayBuffer")}} referenced by the
Int16Array
Fixed at construction time and thus read only. - {{jsxref("TypedArray.prototype.byteLength", "Int16Array.prototype.byteLength")}} {{readonlyInline}}
-
Returns the length (in bytes) of the
Int16Array
from the start of its {{jsxref("ArrayBuffer")}}. Fixed at construction time and thus read only. - {{jsxref("TypedArray.prototype.byteOffset", "Int16Array.prototype.byteOffset")}} {{readonlyInline}}
-
Returns the offset (in bytes) of the
Int16Array
from the start of its {{jsxref("ArrayBuffer")}}. Fixed at construction time and thus read only. - {{jsxref("TypedArray.prototype.length", "Int16Array.prototype.length")}} {{readonlyInline}}
-
Returns the number of elements hold in the
Int16Array
. Fixed at construction time and thus read only.
Methods
- {{jsxref("TypedArray.prototype.copyWithin()", "Int16Array.prototype.copyWithin()")}}
- See {{jsxref("Array.prototype.copyWithin()")}}.
- {{jsxref("TypedArray.prototype.move()", "Int16Array.prototype.move()")}} {{non-standard_inline}} {{unimplemented_inline}}
- Former non-standard version of {{jsxref("TypedArray.prototype.copyWithin()", "Int16Array.prototype.copyWithin()")}}.
- {{jsxref("TypedArray.prototype.set()", "Int16Array.prototype.set()")}}
-
Stores multiple values in the
Int16Array
, reading input values from a specified array. - {{jsxref("TypedArray.prototype.subarray()", "Int16Array.prototype.subarray()")}}
-
Returns a new
Int16Array
from the given start and end element index.
Examples
// 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 = Int16Array(buffer, 0, 4);
Specifications
Specification | Status | Comment |
---|---|---|
Typed Array Specification | Obsolete | Superseded by ECMAScript 6. |
{{SpecName('ES6', '#table-45', 'TypedArray constructors')}} | {{Spec2('ES6')}} | Initial definition in an ECMA standard. |
Browser compatibility
{{ CompatibilityTable() }}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 7.0 | {{ CompatGeckoDesktop("2") }} | 10 | 11.6 | 5.1 |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | 4.0 | {{ CompatVersionUnknown() }} | {{ CompatGeckoMobile("2") }} | 10 | 11.6 | 4.2 |
See also
- JavaScript typed arrays
- {{jsxref("ArrayBuffer")}}
- {{jsxref("DataView")}}