Uint8Array.fromHex()

Die statische Methode Uint8Array.fromHex() erstellt ein neues Uint8Array-Objekt aus einem hexadezimalen String.

Diese Methode analysiert den String in ein Byte-Array. Um den String in eine einzelne Zahl umzuwandeln, verwenden Sie die Funktion parseInt() mit einem radix-Wert von 16.

Syntax

js
Uint8Array.fromHex(string)

Parameter

string

Ein hexadezimaler String, der Bytes codiert, die in ein Uint8Array konvertiert werden sollen. Der String muss:

  • Eine gerade Anzahl von Zeichen haben, da zwei Zeichen ein Byte kodieren.
  • Nur Zeichen des hexadezimalen Alphabets enthalten, das 0–9 und A–F umfasst (Groß-/Kleinschreibung wird nicht berücksichtigt).
  • Keine Leerzeichen enthalten (anders als Uint8Array.prototype.setFromBase64()).

Rückgabewert

Ein neues Uint8Array-Objekt, das die decodierten Bytes aus dem hexadezimalen String enthält.

Ausnahmen

SyntaxError

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

TypeError

Wird ausgelöst, wenn der Eingabestring kein String ist.

Beispiele

Dekodierung eines hexadezimalen Strings

Dieses Beispiel dekodiert einen hexadezimalen String in ein Uint8Array.

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

Großbuchstaben werden ebenfalls unterstützt:

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

Spezifikationen

Specification
Uint8Array to/from base64
# sec-uint8array.fromhex

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch