Summary
The Uint16Array typed array represents an array of 16-bit unsigned 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).
Syntax
Uint16Array(length); Uint16Array(typedArray); Uint16Array(object); Uint16Array(buffer [, byteOffset [, length]]);
For more information about the constructor syntax and the parameters, see TypedArray.
Properties
-
Uint16Array.BYTES_PER_ELEMENT -
Returns a number value of the element size.
2in the case of anUint16Array. - Uint16Array.length
- Length property whose value is 3.
-
Uint16Array.name -
Returns the string value of the constructor name. In the case of the
Uint16Arraytype: "Uint16Array". -
Uint16Array.prototype - Prototype for the TypedArray objects.
Methods
- Uint16Array.from()
-
See
Array.from(). Not implemented, see bug 896608. - Uint16Array.of()
-
See
Array.of(). Not implemented, see bug 896608.
Uint16Array prototype
All Uint16Array objects inherit from %TypedArray%.prototype.
Properties
-
Uint16Array.prototype.constructor -
Returns the function that created an instance's prototype. This is the
Uint16Arrayconstructor by default. -
Uint16Array.prototype.bufferRead only -
Returns the
ArrayBufferreferenced by theUint16ArrayFixed at construction time and thus read only. -
Uint16Array.prototype.byteLengthRead only -
Returns the length (in bytes) of the
Uint16Arrayfrom the start of itsArrayBuffer. Fixed at construction time and thus read only. -
Uint16Array.prototype.byteOffsetRead only -
Returns the offset (in bytes) of the
Uint16Arrayfrom the start of itsArrayBuffer. Fixed at construction time and thus read only. -
Uint16Array.prototype.lengthRead only -
Returns the number of elements hold in the
Uint16Array. Fixed at construction time and thus read only.
Methods
-
Uint16Array.prototype.copyWithin() -
See
Array.prototype.copyWithin(). -
Uint16Array.prototype.move()Unimplemented -
Former non-standard version of
Uint16Array.prototype.copyWithin(). -
Uint16Array.prototype.set() -
Stores multiple values in the
Uint16Array, reading input values from a specified array. -
Uint16Array.prototype.subarray() -
Returns a new
Uint16Arrayfrom the given start and end element index.
Examples
// From a length var uint16 = new Uint16Array(2); uint16[0] = 42; console.log(uint16[0]); // 42 console.log(uint16.length); // 2 console.log(uint16.BYTES_PER_ELEMENT); // 2 // From an array var arr = new Uint16Array([21,31]); console.log(arr[1]); // 31 // From another TypedArray var x = new Uint16Array([21, 31]); var y = new Uint16Array(x); console.log(y[0]); // 21 // From an ArrayBuffer var buffer = new ArrayBuffer(8); var z = Uint16Array(buffer, 0, 4);
Specifications
| Specification | Status | Comment |
|---|---|---|
| Typed Array Specification | Obsolete | Superseded by ECMAScript 6. |
| ECMAScript 6 (ECMA-262) The definition of 'TypedArray constructors' in that specification. |
Draft | Initial definition in an ECMA standard. |
Browser compatibility
Help improve compatibility tables by filling out this 11 question survey.
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | 7.0 | 4.0 (2) | 10 | 11.6 | 5.1 |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | 4.0 | (Yes) | 4.0 (2) | 10 | 11.6 | 4.2 |