【Node.js24.x】Uint8ClampedArray::Uint8ClampedArray()関数の使い方
Uint8ClampedArray関数の使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Uint8ClampedArray関数は、8ビットの符号なし整数を要素として格納する型付き配列を生成する関数です。この配列の各要素は、0から255までの範囲の値を保持し、この範囲外の値が設定されようとした場合には、自動的に0または255に丸め込まれる「クランプ」と呼ばれる特殊な処理が行われます。具体的には、0未満の値は0に、255を超える値は255に調整されます。
主に、WebブラウザのCanvas APIにおける画像データ操作や、Web Workersを用いた並列処理でのバイナリデータ交換、または生のバイトデータを効率的に扱う際に利用されます。例えば、画像を構成する各ピクセルの赤、緑、青、アルファ（透明度）の各チャンネルの値を格納し、操作するために最適化されています。
新しいUint8ClampedArrayのインスタンスを作成する際には、配列の長さを指定したり、既存のArrayBufferから特定の範囲をビューとして作成したり、または別の配列や反復可能なオブジェクトから値をコピーして初期化したりすることができます。これにより、メモリ効率の良い方法で大量の数値データを扱うことが可能になり、特にグラフィックス処理やパフォーマンスが要求される場面で重要な役割を果たします。
構文(syntax)
1const uint8ClampedArray = new Uint8ClampedArray(10);
引数(parameters)
引数なし
引数はありません
戻り値(return)
Uint8ClampedArray
Uint8ClampedArray コンストラクタは、0から255の範囲にクランプ（制限）された8ビット符号なし整数を格納する新しい Uint8ClampedArray オブジェクトを返します。