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