Uint8ClampedArray は型付き配列で、 0-255 に制約される 8 ビット符号なし整数値の配列を表します。指定された値が [0,255] の範囲を超えた場合、 0 または 255 が代わりに設定されます。整数以外を指定しようとすると、最も近い整数が設定されます。中身は0 で初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字の構文 (すなわち、ブラケット記法) を使用するかして参照することができます。

コンストラクター

Uint8ClampedArray()

新しいUint8ClampedArray オブジェクトを生成します。

静的プロパティ

Uint8ClampedArray.BYTES_PER_ELEMENT

要素の大きさを数値で返します。Uint8ClampedArray の場合は1 です。

Uint8ClampedArray.name

コンストラクター名を文字列値で返します。Uint8ClampedArray の場合、 "Uint8ClampedArray" です。

静的メソッド

Uint8ClampedArray.from()

配列風オブジェクトまたは反復可能オブジェクトから新しいUint8ClampedArray オブジェクトを生成します。Array.from() も参照してください。

Uint8ClampedArray.of()

可変長引数で新しいUint8ClampedArray オブジェクトを生成します。Array.of() も参照してください。

インスタンスプロパティ

Uint8ClampedArray.prototype.buffer

Uint8ClampedArray オブジェクトによって参照されるArrayBuffer を返します。構築時に固定され、読み取り専用です。

Uint8ClampedArray.prototype.byteLength

Uint8ClampedArray のArrayBuffer の先頭からの長さを (バイト単位で) 返します。構築時に固定され、読み取り専用です。

Uint8ClampedArray.prototype.byteOffset

ArrayBuffer の先頭からのUint8ClampedArray のオフセットを (バイト単位で) 返します。構築時に固定され、読み取り専用です。

Uint8ClampedArray.prototype.length

Uint8ClampedArray オブジェクト内に保持されている要素の数を返します。構築時に固定され、読み取り専用です。

インスタンスメソッド

Uint8ClampedArray.prototype.copyWithin()

配列内で一連の配列要素をコピーします。Array.prototype.copyWithin() も参照してください。

Uint8ClampedArray.prototype.entries()

配列内ですべての位置におけるキーと値の組を提供する新しい配列イテレーターを返します。Array.prototype.entries() も参照してください。

Uint8ClampedArray.prototype.every()

配列内のすべての要素が関数によって提供されたテストに合格するかどうかテストを実行します。Array.prototype.every() も参照してください。

Uint8ClampedArray.prototype.fill()

配列の先頭位置から末尾位置までのすべての要素を固定値に設定します。Array.prototype.fill() も参照してください。

Uint8ClampedArray.prototype.filter()

この配列のすべての要素のうち、与えられたフィルタリング関数がtrue を返すものをもつ新しい配列を生成します。Array.prototype.filter() も参照してください。

Uint8ClampedArray.prototype.find()

配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった値を返します。見つからなければundefined を返します。Array.prototype.find() も参照してください。

Uint8ClampedArray.prototype.findIndex()

配列内の要素に与えられたテスト関数を満足するものがあったら、見つかった位置を返します。見つからなければ-1 を返します。Array.prototype.findIndex() も参照してください。

Uint8ClampedArray.prototype.forEach()

配列内のそれぞれの要素について関数を呼び出します。Array.prototype.forEach() も参照してください。

Uint8ClampedArray.prototype.includes()

型付き配列に特定の要素があるかどうかを判断し、それに応じてtrue かfalseを返します。Array.prototype.includes() も参照してください。

Uint8ClampedArray.prototype.indexOf()

指定された値に等しい配列内の要素の最初の (最小の) 位置を返します。見つからなかった場合、-1 を返します。Array.prototype.indexOf() も参照してください。

Uint8ClampedArray.prototype.join()

配列のすべての要素を 1 つの文字列に結合します。Array.prototype.join() も参照してください。

Uint8ClampedArray.prototype.keys()

配列内ですべての位置におけるキーを提供する新しい配列イテレーターを返します。Array.prototype.keys() も参照してください。

Uint8ClampedArray.prototype.lastIndexOf()

指定された値に等しい配列内の要素の最後の (最大の) 位置を返します。見つからなかった場合、-1 を返します。Array.prototype.lastIndexOf() も参照してください。

Uint8ClampedArray.prototype.map()

この配列のすべての要素で与えられた関数を呼び出した結果をもつ新しい配列を生成します。Array.prototype.map() も参照してください。

Uint8ClampedArray.prototype.reduce()

アキュムレーターとこの配列のそれぞれの値に対して (左から右へ) 関数を適用し、単一の値に還元します。Array.prototype.reduce() も参照してください。

Uint8ClampedArray.prototype.reduceRight()

アキュムレーターとこの配列のそれぞれの値に対して (右から左へ) 関数を適用し、単一の値に還元します。Array.prototype.reduceRight() も参照してください。

Uint8ClampedArray.prototype.reverse()

配列の要素の順番を反転させます。最初の要素は最後になり、最後の要素は最初になります。Array.prototype.reverse() も参照してください。

Uint8ClampedArray.prototype.set()

入力値を指定した配列から読み込み、この型付き配列内に複数の値を格納します。

Uint8ClampedArray.prototype.slice()

配列の一部を取り出して新しい配列を返します。Array.prototype.slice() も参照してください。

Uint8ClampedArray.prototype.some()

この配列の 1 つ以上の要素が与えられたテスト関数を満たした場合にtrue を返します。Array.prototype.some() も参照してください。

Uint8ClampedArray.prototype.sort()

配列の要素をその場で並べ替え、その配列を返します。Array.prototype.sort() も参照してください。

Uint8ClampedArray.prototype.subarray()

指定された先頭と末尾の要素位置から新しいUint8ClampedArray を返します。

Uint8ClampedArray.prototype.values()

配列内ですべての位置における値を提供する新しい配列イテレーターを返します。Array.prototype.values() も参照してください。

Uint8ClampedArray.prototype.toLocaleString()

配列とその要素を表すローカライズされた文字列を返します。Array.prototype.toLocaleString() も参照してください。

Uint8ClampedArray.prototype.toString()

配列とその要素を表す文字列を返します。Array.prototype.toString() も参照してください。

Uint8ClampedArray.prototype[Symbol.iterator]()

配列内ですべての位置における値を提供する新しい配列イテレーターを返します。

例

様々な方法でUint8ClampedArray を作成

// 長さからvar uintc8 = new Uint8ClampedArray(2);uintc8[0] = 42;uintc8[1] = 1337;console.log(uintc8[0]); // 42console.log(uintc8[1]); // 255 (制約を受けた)console.log(uintc8.length); // 2console.log(uintc8.BYTES_PER_ELEMENT); // 1// 配列からvar 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// ArrayBuffer からvar buffer = new ArrayBuffer(8);var z = new Uint8ClampedArray(buffer, 1, 4);// 反復可能オブジェクトからvar iterable = (function* () {  yield* [1, 2, 3];})();var uintc8 = new Uint8ClampedArray(iterable);// Uint8ClampedArray[1, 2, 3]

仕様書

ブラウザーの互換性

関連情報

• Uint8ClampedArray のポリフィルがcore-js で利用できます
• JavaScript の型付き配列
• ArrayBuffer
• DataView