Class Uint8ClampedArray
An optimized array to store 8-bit unsigned integer numbers. If a value outside of the range 0-255 is attempted to be set, either 0 or 255 is set instead. Elements of this array are stored in an ArrayBuffer object.
API Version:
Available from version 21.2.
| Constant | Description |
|---|---|
| BYTES_PER_ELEMENT: Number = 1 | Number value of the element size. |
| Property | Description |
|---|---|
| buffer: ArrayBuffer | The array buffer referenced by this typed array. |
| byteLength: Number | The number of bytes in the array buffer used by this typed array. |
| byteOffset: Number | The start offset for this typed array within the array buffer. |
| length: Number | The number of elements. |
| Constructor | Description |
|---|---|
| Uint8ClampedArray() | Creates an empty array. |
| Uint8ClampedArray(Number) | Creates an array with the given element count. |
| Uint8ClampedArray(Object) | Creates an array as a copy of the passed typed array. |
| Uint8ClampedArray(Array) | Creates an array as a copy of the passed array. |
| Uint8ClampedArray(ArrayBuffer, Number, Number) | Creates a typed array as a view on the given ArrayBuffer. |
| Method | Description |
|---|---|
| get(Number) | Returns the value at the specified index. |
| set(Object, Number) | Copies all values from the source array into this typed array. |
| subarray(Number, Number) | Returns a new array object based on the same ArrayBuffer store. |
assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values
- BYTES_PER_ELEMENT: Number = 1
Number value of the element size.
- buffer: ArrayBuffer
The array buffer referenced by this typed array.
- byteLength: Number
The number of bytes in the array buffer used by this typed array.
- byteOffset: Number
The start offset for this typed array within the array buffer.
- length: Number
The number of elements.
- Uint8ClampedArray()
Creates an empty array.
- Uint8ClampedArray(length: Number)
Creates an array with the given element count.
Parameters:
- length - The number of elements.
- Uint8ClampedArray(typedArray: Object)
Creates an array as a copy of the passed typed array.
Parameters:
- typedArray - The source typed array.
- Uint8ClampedArray(array: Array)
Creates an array as a copy of the passed array.
Parameters:
- array - The source array.
- Uint8ClampedArray(buffer: ArrayBuffer, byteOffset: Number, length: Number)
Creates a typed array as a view on the given ArrayBuffer.
Parameters:
- buffer - The array buffer storage object.
- byteOffset - Optional. The offset within the array buffer in bytes.
- length - Optional. The number of elements for the target typed array. The passed array buffer must be large enough to store the number of elements specified.
- get(index: Number): Number
Returns the value at the specified index.
Note: This is not ECMAScript standard. Use array element access syntax for single value access.
Parameters:
- index - The index to use.
Returns:
- The value at the specified index.
- set(values: Object, offset: Number): void
Copies all values from the source array into this typed array.
Parameters:
- values - The source values. Can be an array or a typed array.
- offset - Optional. Target offset.
- subarray(begin: Number, end: Number): Uint8ClampedArray
Returns a new array object based on the same ArrayBuffer store.
Parameters:
- begin - Optional. The first included element.
- end - Optional. The index of the end. This element is not included.
Returns:
- The new array object.