Uint8Array

Das Uint8Array typisierte Array stellt ein Array von 8-Bit-Unsigned-Integern dar. Der Inhalt wird auf 0 initialisiert, es sei denn, es werden explizit Initialisierungsdaten bereitgestellt. Sobald es erstellt ist, können Sie auf Elemente im Array entweder mittels der Methoden des Objekts oder mittels der Standard-Array-Indizierungs-Syntax (d.h. unter Verwendung der Klammernotation) zugreifen.

Uint8Array ist eine Unterklasse der verborgenen TypedArray Klasse.

Beschreibung

Uint8Array ist derzeit die einzige TypedArray-Unterklasse, die zusätzliche Methoden im Vergleich zu anderen typisierten Arrays hat. Aufgrund seiner Natur als generisches Byte-Array ist es am besten geeignet für die Arbeit mit beliebigen binären Daten. Es unterstützt zwei Methodensätze zur Erstellung, Serialisierung und Modifikation von Uint8Array-Daten zu/von Hex-Strings und Base64-Strings.

• Uint8Array.fromBase64(), Uint8Array.prototype.toBase64() und Uint8Array.prototype.setFromBase64() zur Arbeit mit Base64-Strings, wobei 3 Bytes durch 4 Zeichen kodiert werden, die entweder 0–9, A–Z, a–z, "+", und "/" (oder "-" und "_", wenn URL-sicheres Base64 verwendet wird) sind.
• Uint8Array.fromHex(), Uint8Array.prototype.toHex() und Uint8Array.prototype.setFromHex() zur Arbeit mit Hex-Strings, wobei jedes Byte durch zwei Zeichen kodiert wird, die entweder 0–9 oder A–F (nicht groß-/kleinbuchstabensensitiv) sind.

Konstruktor

Uint8Array()

Erstellt ein neues Uint8Array-Objekt.

Statische Eigenschaften

Erbt auch statische Eigenschaften von seinem Eltern TypedArray .

Uint8Array.BYTES_PER_ELEMENT

Gibt den numerischen Wert der Elementgröße zurück. 1 im Fall von Uint8Array.

Statische Methoden

Erbt statische Methoden von seinem Eltern TypedArray .

Uint8Array.fromBase64()

Erstellt ein neues Uint8Array-Objekt aus einem base64-kodierten String.

Uint8Array.fromHex()

Erstellt ein neues Uint8Array-Objekt aus einem Hex-kodierten String.

Instanzeigenschaften

Erbt auch Instanzeigenschaften von seinem Eltern TypedArray .

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

Uint8Array.prototype.BYTES_PER_ELEMENT

Gibt den numerischen Wert der Elementgröße zurück. 1 im Fall von einem Uint8Array.

Uint8Array.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für Uint8Array-Instanzen ist der Anfangswert der Uint8Array Konstruktor.

Instanzmethoden

Erbt Instanzmethoden von seinem Eltern TypedArray .

Uint8Array.prototype.setFromBase64()

Füllt dieses Uint8Array-Objekt mit Bytes aus einem base64-kodierten String und gibt ein Objekt zurück, das angibt, wie viele Bytes gelesen und geschrieben wurden.

Uint8Array.prototype.setFromHex()

Füllt dieses Uint8Array-Objekt mit Bytes aus einem Hex-kodierten String und gibt ein Objekt zurück, das angibt, wie viele Bytes gelesen und geschrieben wurden.

Uint8Array.prototype.toBase64()

Gibt einen base64-kodierten String basierend auf den Daten in diesem Uint8Array-Objekt zurück.

Uint8Array.prototype.toHex()

Gibt einen Hex-kodierten String basierend auf den Daten in diesem Uint8Array-Objekt zurück.

Beispiele

Verschiedene Möglichkeiten, ein Uint8Array zu erstellen

// From a length
const uint8 = new Uint8Array(2);
uint8[0] = 42;
console.log(uint8[0]); // 42
console.log(uint8.length); // 2
console.log(uint8.BYTES_PER_ELEMENT); // 1
// From an array
const x = new Uint8Array([21, 31]);
console.log(x[1]); // 31
// From another TypedArray
const y = new Uint8Array(x);
console.log(y[0]); // 21
// From an ArrayBuffer
const buffer = new ArrayBuffer(8);
const z = new Uint8Array(buffer, 1, 4);
console.log(z.byteOffset); // 1
// From an iterable
const iterable = (function* () {
 yield* [1, 2, 3];
})();
const uint8FromIterable = new Uint8Array(iterable);
console.log(uint8FromIterable);
// Uint8Array [1, 2, 3]

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill von Uint8Array in core-js
• JavaScript typisierte Arrays Leitfaden
• TypedArray
• ArrayBuffer
• DataView