Uint8Array.fromHex() - JavaScript | MDN

Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 einem Hexadezimal-String.

Diese Methode parst den String in ein Byte-Array. Um den String in eine einzelne Zahl zu konvertieren, verwenden Sie stattdessen die parseInt()-Funktion mit radix auf 16 gesetzt.

Syntax

js
Uint8Array.fromHex(string)

Parameter

string

Ein Hexadezimal-String, der Bytes codiert und in ein Uint8Array konvertiert werden soll. Der String muss:

  • Eine gerade Anzahl von Zeichen haben, da zwei Zeichen ein Byte codieren.
  • Nur Zeichen des hexadezimalen Alphabets enthalten, welches 0–9 und A–F (groß-/kleinschreibungsunabhängig) einschließt.
  • Keine Leerzeichen enthalten (anders als Uint8Array.prototype.setFromBase64()).

Rückgabewert

Ein neues Uint8Array-Objekt, welches die dekodierten Bytes des Hexadezimal-Strings enthält.

Ausnahmen

SyntaxError

Wird ausgelöst, wenn der Eingabe-String Zeichen außerhalb des hexadezimalen Alphabets enthält oder seine Länge ungerade ist.

TypeError

Wird ausgelöst, wenn der Eingabe-String keine Zeichenkette ist.

Beispiele

>

Dekodieren eines Hexadezimal-Strings

Dieses Beispiel dekodiert einen Hexadezimal-String in ein Uint8Array.

js
const hexString = "cafed00d";
const bytes = Uint8Array.fromHex(hexString);
console.log(bytes); // Uint8Array [ 202, 254, 208, 13 ]

Auch Großbuchstaben werden unterstützt:

js
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>

Browser-Kompatibilität

Siehe auch