Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
Uint8Array
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
* Some parts of this feature may have varying levels of support.
DasUint8Array typisierte Array stellt ein Array von 8-Bit-Unsigned-Integern dar. Der Inhalt wird auf0 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 verborgenenTypedArray Klasse.
In diesem Artikel
Beschreibung
Uint8Array ist derzeit die einzigeTypedArray-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 vonUint8Array-Daten zu/von Hex-Strings und Base64-Strings.
Uint8Array.fromBase64(),Uint8Array.prototype.toBase64()undUint8Array.prototype.setFromBase64()zur Arbeit mitBase64-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()undUint8Array.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 ElternTypedArray.
Uint8Array.BYTES_PER_ELEMENTGibt den numerischen Wert der Elementgröße zurück.
1im Fall vonUint8Array.
Statische Methoden
Erbt statische Methoden von seinem ElternTypedArray.
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 ElternTypedArray.
Diese Eigenschaften sind aufUint8Array.prototype definiert und werden von allenUint8Array-Instanzen geteilt.
Uint8Array.prototype.BYTES_PER_ELEMENTGibt den numerischen Wert der Elementgröße zurück.
1im Fall von einemUint8Array.Uint8Array.prototype.constructorDie Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für
Uint8Array-Instanzen ist der Anfangswert derUint8ArrayKonstruktor.
Instanzmethoden
Erbt Instanzmethoden von seinem ElternTypedArray.
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 lengthconst uint8 = new Uint8Array(2);uint8[0] = 42;console.log(uint8[0]); // 42console.log(uint8.length); // 2console.log(uint8.BYTES_PER_ELEMENT); // 1// From an arrayconst x = new Uint8Array([21, 31]);console.log(x[1]); // 31// From another TypedArrayconst y = new Uint8Array(x);console.log(y[0]); // 21// From an ArrayBufferconst buffer = new ArrayBuffer(8);const z = new Uint8Array(buffer, 1, 4);console.log(z.byteOffset); // 1// From an iterableconst iterable = (function* () { yield* [1, 2, 3];})();const uint8FromIterable = new Uint8Array(iterable);console.log(uint8FromIterable);// Uint8Array [1, 2, 3]Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-typedarray-objects> |