Uint8ClampedArray

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Das Uint8ClampedArray typisierte Array stellt ein Array von 8-Bit-Ganzzahlen ohne Vorzeichen dar, die auf 0–255 begrenzt sind. Der Inhalt wird standardmäßig auf 0 initialisiert, es sei denn, es werden explizit Initialisierungsdaten bereitgestellt. Sobald das Array erstellt ist, können Sie auf die Elemente im Array über die Methoden des Objekts oder über die standardmäßige Array-Indizierungssyntax (also unter Verwendung von Klammern) zugreifen.

Uint8ClampedArray ist eine Unterklasse der versteckten TypedArray Klasse.

Konstruktor

Uint8ClampedArray()

Erstellt ein neues Uint8ClampedArray-Objekt.

Statische Eigenschaften

Erbt auch statische Eigenschaften von seinem Elternteil TypedArray.

Uint8ClampedArray.BYTES_PER_ELEMENT

Gibt einen Zahlenwert der Elementgröße zurück. 1 im Fall von Uint8ClampedArray.

Statische Methoden

Erbt statische Methoden von seinem Elternteil TypedArray.

Instanzeigenschaften

Erbt auch Instanzeigenschaften von seinem Elternteil TypedArray.

Diese Eigenschaften sind definiert auf Uint8ClampedArray.prototype und werden von allen Uint8ClampedArray-Instanzen geteilt.

Uint8ClampedArray.prototype.BYTES_PER_ELEMENT

Gibt einen Zahlenwert der Elementgröße zurück. 1 im Fall eines Uint8ClampedArray.

Uint8ClampedArray.prototype.constructor

Die Konstruktionsfunktion, die das Instanzobjekt erstellt hat. Für Uint8ClampedArray-Instanzen ist der anfängliche Wert der Uint8ClampedArray Konstruktor.

Instanzmethoden

Erbt Instanzmethoden von seinem Elternteil TypedArray.

Beispiele

Verschiedene Wege, ein Uint8ClampedArray zu erstellen

js
// From a length
const uint8c = new Uint8ClampedArray(2);
uint8c[0] = 42;
uint8c[1] = 1337;
console.log(uint8c[0]); // 42
console.log(uint8c[1]); // 255 (clamped)
console.log(uint8c.length); // 2
console.log(uint8c.BYTES_PER_ELEMENT); // 1

// From an array
const x = new Uint8ClampedArray([21, 31]);
console.log(x[1]); // 31

// From another TypedArray
const y = new Uint8ClampedArray(x);
console.log(y[0]); // 21

// From an ArrayBuffer
const buffer = new ArrayBuffer(8);
const z = new Uint8ClampedArray(buffer, 1, 4);
console.log(z.byteOffset); // 1

// From an iterable
const iterable = (function* () {
  yield* [1, 2, 3];
})();
const uint8cFromIterable = new Uint8ClampedArray(iterable);
console.log(uint8cFromIterable);
// Uint8ClampedArray [1, 2, 3]

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-typedarray-objects

Browser-Kompatibilität

Siehe auch