Uint8ClampedArray() constructor
The Uint8ClampedArray()
constructor creates a typed array
of 8-bit unsigned integers clamped to 0-255; if you specified a value that is out of the
range of [0,255], 0 or 255 will be set instead; if you specify a non-integer, the
nearest integer will be set. 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
new Uint8ClampedArray()
new Uint8ClampedArray(length)
new Uint8ClampedArray(typedArray)
new Uint8ClampedArray(object)
new Uint8ClampedArray(buffer)
new Uint8ClampedArray(buffer, byteOffset)
new Uint8ClampedArray(buffer, byteOffset, length)
Parameters
See TypedArray
.
Exceptions
See TypedArray
.
Examples
Different ways to create a Uint8ClampedArray
// From a length
const uintc8 = new Uint8ClampedArray(2);
uintc8[0] = 42;
uintc8[1] = 1337;
console.log(uintc8[0]); // 42
console.log(uintc8[1]); // 255 (clamped)
console.log(uintc8.length); // 2
console.log(uintc8.BYTES_PER_ELEMENT); // 1
// From an array
const x = new Uint8ClampedArray([21, 31]);
console.log(x[1]); // 31
// From another TypedArray
const y = new Uint8ClampedArray(x);
console.log(y[0]); // 21
// From an ArrayBuffer
const buffer = new ArrayBuffer(8);
const z = new Uint8ClampedArray(buffer, 1, 4);
console.log(z.byteOffset); // 1
// From an iterable
const iterable = (function* () {
yield* [1, 2, 3];
})();
const uintc8FromIterable = new Uint8ClampedArray(iterable);
console.log(uintc8FromIterable);
// Uint8ClampedArray [1, 2, 3]
Specifications
Specification |
---|
ECMAScript Language Specification # sec-typedarray-constructors |
Browser compatibility
BCD tables only load in the browser