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
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
.
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
Specification |
---|
Uint8Array to/from base64 # sec-uint8array.fromhex |
Browser-Kompatibilität
BCD tables only load in the browser