--- title: Uint8ClampedArray slug: Web/JavaScript/Reference/Global_Objects/Uint8ClampedArray tags: - Class - JavaScript - TypedArray - TypedArrays translation_of: Web/JavaScript/Reference/Global_Objects/Uint8ClampedArray ---
{{JSRef}}

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

コンストラクター

{{jsxref("Global_Objects/Uint8ClampedArray/Uint8ClampedArray", "Uint8ClampedArray()")}}
新しい Uint8ClampedArray オブジェクトを生成します。

静的プロパティ

{{jsxref("TypedArray.BYTES_PER_ELEMENT", "Uint8ClampedArray.BYTES_PER_ELEMENT")}}
要素の大きさの数値を返します。 Uint8ClampedArray の場合は 1 になります。
{{jsxref("TypedArray.name", "Uint8ClampedArray.name")}}
コンストラクターの名前を文字列値で返します。 Uint8ClampedArray 型の場合は "Uint8ClampedArray" です。

静的メソッド

{{jsxref("TypedArray.from", "Uint8ClampedArray.from()")}}
新しい Uint8ClampedArray を、配列風オブジェクトや反復可能オブジェクトから生成します。 {{jsxref("Array.from()")}} も参照してください。
{{jsxref("TypedArray.of", "Uint8ClampedArray.of()")}}
新しい Uint8ClampedArray を、可変長引数から生成します。 {{jsxref("Array.of()")}} も参照してください。

インスタンスプロパティ

{{jsxref("TypedArray.prototype.buffer", "Uint8ClampedArray.prototype.buffer")}}
Uint8ClampedArray オブジェクトによって参照される {{jsxref("ArrayBuffer")}} を返します。構築時に設定され、読取専用です。
{{jsxref("TypedArray.prototype.byteLength", "Uint8ClampedArray.prototype.byteLength")}}
Uint8ClampedArray の長さを {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、読取専用です。
{{jsxref("TypedArray.prototype.byteOffset", "Uint8ClampedArray.prototype.byteOffset")}}
Uint8ClampedArray のオフセットを、 {{jsxref("ArrayBuffer")}} の先頭からのバイト単位で返します。構築時に設定され、読取専用です。
{{jsxref("TypedArray.prototype.length", "Uint8ClampedArray.prototype.length")}}
Uint8ClampedArray オブジェクト内に保持されている要素の数を返します。構築時に設定され、読取専用です。

インスタンスメソッド

{{jsxref("TypedArray.copyWithin", "Uint8ClampedArray.prototype.copyWithin()")}}
配列内で一連の配列要素をコピーします。 {{jsxref("Array.prototype.copyWithin()")}} も参照してください。
{{jsxref("TypedArray.entries", "Uint8ClampedArray.prototype.entries()")}}
配列内の各添字に対するキーと値の組を含む、新しい配列イテレーターを返します。 {{jsxref("Array.prototype.entries()")}} も参照してください。
{{jsxref("TypedArray.every", "Uint8ClampedArray.prototype.every()")}}
配列内のすべての要素に対して、指定された関数によるテストに合格するかどうかをテストします。 {{jsxref("Array.prototype.every()")}} も参照してください。
{{jsxref("TypedArray.fill", "Uint8ClampedArray.prototype.fill()")}}
配列の先頭から末尾までのすべての要素を固定値で設定します。 {{jsxref("Array.prototype.fill()")}} も参照してください。
{{jsxref("TypedArray.filter", "Uint8ClampedArray.prototype.filter()")}}
この配列のすべての要素のうち、指定されたフィルタリング関数が与えられたフィルタリング関数が true を返すすべての要素で、新しい配列を生成します。 {{jsxref("Array.prototype.filter()")}} も参照してください。
{{jsxref("TypedArray.find", "Uint8ClampedArray.prototype.find()")}}
指定されたテスト関数を満足する要素が見つかった場合、その値を返します。見つからなかった場合は undefined を返します。 {{jsxref("Array.prototype.find()")}} も参照してください。
{{jsxref("TypedArray.findIndex", "Uint8ClampedArray.prototype.findIndex()")}}
指定されたテスト関数を満足する要素が見つかった場合、その添字を返します。見つからなかった場合は -1 を返します。 {{jsxref("Array.prototype.findIndex()")}} も参照してください。
{{jsxref("TypedArray.forEach", "Uint8ClampedArray.prototype.forEach()")}}
配列内の各要素に対してある関数を呼び出します。 {{jsxref("Array.prototype.forEach()")}} も参照してください。
{{jsxref("TypedArray.includes", "Uint8ClampedArray.prototype.includes()")}}
型付き配列にある要素が含まれているかどうかを判断し、それに応じて true または false を返します。 {{jsxref("Array.prototype.includes()")}} も参照してください。
{{jsxref("TypedArray.indexOf", "Uint8ClampedArray.prototype.indexOf()")}}
配列内の要素のうち、指定された値と等しい最初の要素の添字を返します。見つからない場合は -1 を返します。 {{jsxref("Array.prototype.indexOf()")}} も参照してください。
{{jsxref("TypedArray.join", "Uint8ClampedArray.prototype.join()")}}
すべての配列要素を1つの文字列に結合します。 {{jsxref("Array.prototype.join()")}} も参照してください。
{{jsxref("TypedArray.keys", "Uint8ClampedArray.prototype.keys()")}}
配列内のすべての添字に対するキーを含む新しい配列イテレーターを返します。 {{jsxref("Array.prototype.keys()")}} も参照してください。
{{jsxref("TypedArray.lastIndexOf", "Uint8ClampedArray.prototype.lastIndexOf()")}}
配列内の要素のうち、指定された値と等しい最後の要素の添字を返します。見つからない場合は -1 を返します。 {{jsxref("Array.prototype.lastIndexOf()")}} も参照してください。
{{jsxref("TypedArray.map", "Uint8ClampedArray.prototype.map()")}}
この配列のすべての要素を引数として指定された関数を呼び出し、その結果で新しい配列を生成します。 {{jsxref("Array.prototype.map()")}} も参照してください。
{{jsxref("TypedArray.reduce", "Uint8ClampedArray.prototype.reduce()")}}
アキュームレーターと配列の各要素に対して (左から右へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduce()")}} も参照してください。
{{jsxref("TypedArray.reduceRight", "Uint8ClampedArray.prototype.reduceRight()")}}
アキュームレーターと配列の各要素に対して (右から左へ) 関数を適用し、単一の値に縮小します。 {{jsxref("Array.prototype.reduceRight()")}} も参照してください。
{{jsxref("TypedArray.reverse", "Uint8ClampedArray.prototype.reverse()")}}
配列要素の順番を反転させます。 — 最初の要素は最後になり、最後の要素は最初になります。 {{jsxref("Array.prototype.reverse()")}} も参照してください。
{{jsxref("TypedArray.set", "Uint8ClampedArray.prototype.set()")}}
指定された配列から複数の入力値を読み込み、型付き配列に格納します。
{{jsxref("TypedArray.slice", "Uint8ClampedArray.prototype.slice()")}}
配列の一区間を取り出して新しい配列を返します。 {{jsxref("Array.prototype.slice()")}} も参照してください。
{{jsxref("TypedArray.some", "Uint8ClampedArray.prototype.some()")}}
この配列内で、指定されたテスト関数を満たす要素が1つでもあった場合に true を返します。 {{jsxref("Array.prototype.some()")}} も参照してください。
{{jsxref("TypedArray.sort", "Uint8ClampedArray.prototype.sort()")}}
配列の要素をその場でソートし、その配列を返します。 {{jsxref("Array.prototype.sort()")}} も参照してください。
{{jsxref("TypedArray.subarray", "Uint8ClampedArray.prototype.subarray()")}}
指定された開始位置と終了位置の間にある要素から新しい Uint8ClampedArray を返します。
{{jsxref("TypedArray.values", "Uint8ClampedArray.prototype.values()")}}
配列内の各添字に対する値を含む新しい配列イテレーターを返します。 {{jsxref("Array.prototype.values()")}} も参照してください。
{{jsxref("TypedArray.toLocaleString", "Uint8ClampedArray.prototype.toLocaleString()")}}
配列と要素を表すローカライズされた文字列を返します。 {{jsxref("Array.prototype.toLocaleString()")}} も参照してください。
{{jsxref("TypedArray.toString", "Uint8ClampedArray.prototype.toString()")}}
配列と要素を表す文字列を返します。 {{jsxref("Array.prototype.toString()")}} も参照してください。
{{jsxref("TypedArray.@@iterator", "Uint8ClampedArray.prototype[@@iterator]()")}}
配列内のそれぞれの添字の値を含む新しい配列イテレーターオブジェクトを返します。

例

Uint8ClampedArray を生成する様々な方法

// 長さを指定
var 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

// 配列から
var arr = new Uint8ClampedArray([21,31]);
console.log(arr[1]); // 31

// 他の型付き配列から
var 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]

仕様書

仕様書
{{SpecName('ESDraft', '#table-49', 'TypedArray constructors')}}

ブラウザーの互換性

{{Compat("javascript.builtins.Uint8ClampedArray")}}

関連情報