Uint8Array.fromHex()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

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

Browser-Kompatibilität

Siehe auch