Uint16Array

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. 2 in the case of an Uint16Array.

Uint16Array.length

Length property whose value is 3.

Uint16Array.name

Returns the string value of the constructor name. In the case of the Uint16Array type: "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 Uint16Array constructor by default.

Uint16Array.prototype.buffer Read only

Returns the ArrayBuffer referenced by the Uint16Array Fixed at construction time and thus read only.

Uint16Array.prototype.byteLength Read only

Returns the length (in bytes) of the Uint16Array from the start of its ArrayBuffer. Fixed at construction time and thus read only.

Uint16Array.prototype.byteOffset Read only

Returns the offset (in bytes) of the Uint16Array from the start of its ArrayBuffer. Fixed at construction time and thus read only.

Uint16Array.prototype.length Read 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.entries()

Returns a new Array Iterator object that contains the key/value pairs for each index in the array.

Uint16Array.prototype.keys()

Returns a new Array Iterator that contains the keys for each index in the array.

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 Uint16Array from the given start and end element index.

Uint16Array.prototype.values()

Returns a new Array Iterator object that contains the values for each index in the array.

Uint16Array.prototype[@@iterator]()

Returns a new Array Iterator object that contains the values for each index in the array.

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 = new Uint16Array(buffer, 0, 4);

Specifications

Browser compatibility

See also

• JavaScript typed arrays
• ArrayBuffer
• DataView