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
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
.
const hexString = "cafed00d";
const bytes = Uint8Array.fromHex(hexString);
console.log(bytes); // Uint8Array [ 202, 254, 208, 13 ]
Auch Großbuchstaben werden 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 |