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

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
fromHex

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Siehe auch