Uint8ClampedArray
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作し��す。2015年7月以降、すべてのブラウザーで利用可能です。
Uint8ClampedArray は型付き配列で、 0-255 に制約される 8 ビット符号なし整数値の配列を表します。初期化データが明示的に指定されていない限り、内容は 0 に初期化されます。生成されると、配列内の要素はそのオブジェクトのメソッドを使用するか、配列の標準的な添字構文（すなわち、ブラケット記法）を使用するかして参照することができます。
Uint8ClampedArray は非公開の TypedArray クラスのサブクラスです。
コンストラクター
Uint8ClampedArray()-
新しい
Uint8ClampedArrayオブジェクトを生成します。
静的プロパティ
親である TypedArray から継承した静的プロパティもあります。
Uint8ClampedArray.BYTES_PER_ELEMENT-
要素の大きさを数値で返します。
Uint8ClampedArrayの場合は1です。
静的メソッド
親である TypedArray から継承した静的メソッドがあります。
インスタンスプロパティ
親である TypedArray から継承したインスタンスプロパティもあります。
これらのプロパティは Uint8ClampedArray.prototype で定義されており、すべての Uint8ClampedArray インスタンスで共有されています。
Uint8ClampedArray.prototype.BYTES_PER_ELEMENT-
要素の大きさを数値で返します。
Uint8ClampedArrayの場合は1です。 Uint8ClampedArray.prototype.constructor-
このインスタンスオブジェクトを構築したコンストラクター関数です。
Uint8ClampedArrayインスタンスの場合、初期値はUint8ClampedArrayコンストラクターです。
インスタンスメソッド
親である TypedArray から継承したインスタンスメソッドがあります。
例
様々な方法で Uint8ClampedArray を作成
js
// 長さから
const uint8c = new Uint8ClampedArray(2);
uint8c[0] = 42;
uint8c[1] = 1337;
console.log(uint8c[0]); // 42
console.log(uint8c[1]); // 255 (制約を受けた)
console.log(uint8c.length); // 2
console.log(uint8c.BYTES_PER_ELEMENT); // 1
// 配列から
const x = new Uint8ClampedArray([21, 31]);
console.log(x[1]); // 31
// 他の TypedArray から
const y = new Uint8ClampedArray(x);
console.log(y[0]); // 21
// ArrayBuffer から
const buffer = new ArrayBuffer(8);
const z = new Uint8ClampedArray(buffer, 1, 4);
console.log(z.byteOffset); // 1
// 反復可能オブジェクトから
const iterable = (function* () {
yield* [1, 2, 3];
})();
const uint8cFromIterable = new Uint8ClampedArray(iterable);
console.log(uint8cFromIterable);
// Uint8ClampedArray [1, 2, 3]
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-typedarray-objects |