Uint8Array

Beschreibung

Uint8Array ist derzeit die einzige TypedArray-Unterklasse, die zustzliche Methoden im Vergleich zu anderen typisierten Arrays hat. Aufgrund seiner Natur als generisches Byte-Array ist es am besten geeignet fr die Arbeit mit beliebigen binren Daten. Es untersttzt zwei Methodenstze 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 09, AZ, az, "+", 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 09 oder AF (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 Elementgre zurck. 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 Elementgre zurck. 1 im Fall von einem Uint8Array.

Uint8Array.prototype.constructor

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

Instanzmethoden

Erbt Instanzmethoden von seinem Eltern TypedArray.

Uint8Array.prototype.setFromBase64()

Fllt dieses Uint8Array-Objekt mit Bytes aus einem base64-kodierten String und gibt ein Objekt zurck, das angibt, wie viele Bytes gelesen und geschrieben wurden.

Uint8Array.prototype.setFromHex()

Fllt dieses Uint8Array-Objekt mit Bytes aus einem Hex-kodierten String und gibt ein Objekt zurck, 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 zurck.

Uint8Array.prototype.toHex()

Gibt einen Hex-kodierten String basierend auf den Daten in diesem Uint8Array-Objekt zurck.

Beispiele

Verschiedene Mglichkeiten, 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-Kompatibilitt

Siehe auch

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