Типизированный массивUint8ClampedArray — это массив, служащий для хранения 8-битных беззнаковых чисел, обрезаемых до диапазона от 0 до 255. Если значение меньше 0, то оно будет приведено к 0 , и к 255, если оно больше 255. Числа с плавающей точкой округляются с помощью математического округления. Массив инициализируется нулями. После того как значение установлено, вы можете ссылаться на него с помощью методов объекта или через стандартный синтаксис массивов (то есть, брать значения с помощью квадратных скобок).

Syntax

new Uint8ClampedArray(length);new Uint8ClampedArray(typedArray);new Uint8ClampedArray(object);new Uint8ClampedArray(buffer [, byteOffset [, length]]);

Для более подробной информации, смотритеTypedArray.

Properties

Uint8ClampedArray.BYTES_PER_ELEMENT

Возвращает размер элемента в байтах. Для Uint8ClampedArray оно равно 1.

Uint8ClampedArray.length

Static length property whose value is 3. For the actual length (number of elements), seeUint8ClampedArray.prototype.length.

Uint8ClampedArray.name

Returns the string value of the constructor name. In the case of theUint8ClampedArray type: "Uint8ClampedArray".

Uint8ClampedArray.prototype

Prototype for theTypedArray objects.

Methods

Uint8ClampedArray.from()

Creates a newUint8ClampedArray from an array-like or iterable object. See alsoArray.from().

Uint8ClampedArray.of()

Creates a newUint8ClampedArray with a variable number of arguments. See alsoArray.of().

Uint8ClampedArray prototype

AllUint8ClampedArray objects inherit from%TypedArray%.prototype.

Properties

Uint8ClampedArray.prototype.constructor

Returns the function that created an instance's prototype. This is theUint8ClampedArray constructor by default.

Uint8ClampedArray.prototype.bufferТолько для чтения

Returns theArrayBuffer referenced by theUint8ClampedArray Fixed at construction time and thusread only.

Uint8ClampedArray.prototype.byteLengthТолько для чтения

Returns the length (in bytes) of theUint8ClampedArray from the start of itsArrayBuffer. Fixed at construction time and thusread only.

Uint8ClampedArray.prototype.byteOffsetТолько для чтения

Returns the offset (in bytes) of theUint8ClampedArray from the start of itsArrayBuffer. Fixed at construction time and thusread only.

Uint8ClampedArray.prototype.lengthТолько для чтения

Returns the number of elements hold in theUintClamped8Array. Fixed at construction time and thusread only.

Methods

Uint8ClampedArray.prototype.copyWithin()

Copies a sequence of array elements within the array. See alsoArray.prototype.copyWithin().

Uint8ClampedArray.prototype.entries()

Returns a newArray Iterator object that contains the key/value pairs for each index in the array. See alsoArray.prototype.entries().

Uint8ClampedArray.prototype.every()

Tests whether all elements in the array pass the test provided by a function. See alsoArray.prototype.every().

Uint8ClampedArray.prototype.fill()

Fills all the elements of an array from a start index to an end index with a static value. See alsoArray.prototype.fill().

Uint8ClampedArray.prototype.filter()

Creates a new array with all of the elements of this array for which the provided filtering function returns true. See alsoArray.prototype.filter().

Uint8ClampedArray.prototype.find()

Returns the found value in the array, if an element in the array satisfies the provided testing function orundefined if not found. See alsoArray.prototype.find().

Uint8ClampedArray.prototype.findIndex()

Returns the found index in the array, if an element in the array satisfies the provided testing function or -1 if not found. See alsoArray.prototype.findIndex().

Uint8ClampedArray.prototype.forEach()

Calls a function for each element in the array. See alsoArray.prototype.forEach().

Uint8ClampedArray.prototype.includes()Экспериментальная возможность

Determines whether a typed array includes a certain element, returningtrue orfalse as appropriate. See alsoArray.prototype.includes().

Uint8ClampedArray.prototype.indexOf()

Returns the first (least) index of an element within the array equal to the specified value, or -1 if none is found. See alsoArray.prototype.indexOf().

Uint8ClampedArray.prototype.join()

Joins all elements of an array into a string. See alsoArray.prototype.join().

Uint8ClampedArray.prototype.keys()

Returns a newArray Iterator that contains the keys for each index in the array. See alsoArray.prototype.keys().

Uint8ClampedArray.prototype.lastIndexOf()

Returns the last (greatest) index of an element within the array equal to the specified value, or -1 if none is found. See alsoArray.prototype.lastIndexOf().

Uint8ClampedArray.prototype.map()

Creates a new array with the results of calling a provided function on every element in this array. See alsoArray.prototype.map().

Uint8ClampedArray.prototype.reduce()

Apply a function against an accumulator and each value of the array (from left-to-right) as to reduce it to a single value. See alsoArray.prototype.reduce().

Uint8ClampedArray.prototype.reduceRight()

Apply a function against an accumulator and each value of the array (from right-to-left) as to reduce it to a single value. See alsoArray.prototype.reduceRight().

Uint8ClampedArray.prototype.reverse()

Reverses the order of the elements of an array — the first becomes the last, and the last becomes the first. See alsoArray.prototype.reverse().

Uint8ClampedArray.prototype.set()

Stores multiple values in the typed array, reading input values from a specified array.

Uint8ClampedArray.prototype.slice()

Extracts a section of an array and returns a new array. See alsoArray.prototype.slice().

Uint8ClampedArray.prototype.some()

Returns true if at least one element in this array satisfies the provided testing function. See alsoArray.prototype.some().

Uint8ClampedArray.prototype.sort()

Sorts the elements of an array in place and returns the array. See alsoArray.prototype.sort().

Uint8ClampedArray.prototype.subarray()

Returns a newUint8ClampedArray from the given start and end element index.

Uint8ClampedArray.prototype.values()

Returns a newArray Iterator object that contains the values for each index in the array. See alsoArray.prototype.values().

Uint8ClampedArray.prototype.toLocaleString()

Returns a localized string representing the array and its elements. See alsoArray.prototype.toLocaleString().

Uint8ClampedArray.prototype.toString()

Returns a string representing the array and its elements. See alsoArray.prototype.toString().

Uint8ClampedArray.prototype[@@iterator]()

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

Examples

// From a lengthvar uintc8 = new Uint8ClampedArray(2);uintc8[0] = 42;uintc8[1] = 1337;console.log(uintc8[0]); // 42console.log(uintc8[1]); // 255 (clamped)console.log(uintc8.length); // 2console.log(uintc8.BYTES_PER_ELEMENT); // 1// From an arrayvar arr = new Uint8ClampedArray([21, 31]);console.log(arr[1]); // 31// From another TypedArrayvar x = new Uint8ClampedArray([21, 31]);var y = new Uint8ClampedArray(x);console.log(y[0]); // 21// From an ArrayBuffervar buffer = new ArrayBuffer(8);var z = new Uint8ClampedArray(buffer, 1, 4);

Спецификации

Совместимость с браузерами

Compatibility notes

Starting with ECMAScript 2015 (ES6),Uint8ClampedArray constructors require to be constructed with anew operator. Calling aUint8ClampedArray constructor as a function withoutnew, will throw aTypeError from now on.

var dv = Uint8ClampedArray([1, 2, 3]);// TypeError: calling a builtin Uint8ClampedArray constructor// without new is forbidden

var dv = new Uint8ClampedArray([1, 2, 3]);

Смотрите также

• JavaScript typed arrays
• ArrayBuffer
• DataView