Uint8Array.fromHex()
Baseline 2025
Neu verfügbar
Seit September 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die statische Methode Uint8Array.fromHex() erstellt ein neues Uint8Array-Objekt aus einer hexadezimalen Zeichenfolge.
Diese Methode wandelt die Zeichenfolge in ein Byte-Array um. Wenn Sie die Zeichenfolge stattdessen in eine einzelne Zahl umwandeln möchten, verwenden Sie die Funktion parseInt() mit dem Wert 16 für radix.
Syntax
Uint8Array.fromHex(string)
Parameter
string-
Eine hexadezimale Zeichenfolge, die Bytes kodiert, die in ein
Uint8Arrayumgewandelt werden sollen. Die Zeichenfolge muss:- Eine gerade Anzahl von Zeichen haben, da zwei Zeichen ein Byte kodieren.
- Ausschließlich Zeichen des hexadezimalen Alphabets enthalten, also 0–9 und A–F (ohne Unterscheidung zwischen Groß- und Kleinschreibung).
- Frei von Leerraum sein (anders als bei
Uint8Array.prototype.setFromBase64()).
Rückgabewert
Ein neues Uint8Array-Objekt, das die aus der hexadezimalen Zeichenfolge dekodierten Bytes enthält.
Ausnahmen
SyntaxError-
Wird ausgelöst, wenn die Eingabezeichenfolge Zeichen außerhalb des hexadezimalen Alphabets enthält oder ihre Länge ungerade ist.
TypeError-
Wird ausgelöst, wenn die Eingabe keine Zeichenfolge ist.
Beispiele
Dekodieren einer hexadezimalen Zeichenfolge
Dieses Beispiel dekodiert eine hexadezimale Zeichenfolge in ein Uint8Array.
const hexString = "cafed00d";
const bytes = Uint8Array.fromHex(hexString);
console.log(bytes); // Uint8Array [ 202, 254, 208, 13 ]
Großbuchstaben werden ebenfalls unterstützt:
const hexString = "CAFEd00d";
const bytes = Uint8Array.fromHex(hexString);
console.log(bytes); // Uint8Array [ 202, 254, 208, 13 ]
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification # sec-uint8array.fromhex |