Uint8Array.prototype.setFromHex() - JavaScript | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

Uint8Array.prototype.setFromHex()

Baseline 2025

Neu verfügbar

Seit September 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Die setFromHex()-Methode von Uint8Array-Instanzen befüllt dieses Uint8Array-Objekt mit Bytes aus einem hex-kodierten String und gibt ein Objekt zurück, das angibt, wie viele Bytes gelesen und geschrieben wurden.

Diese Methode analysiert den String in ein Byte-Array. Um den String in eine einzelne Zahl umzuwandeln, verwenden Sie stattdessen die parseInt()-Funktion mit radix auf 16 gesetzt.

In diesem Artikel

Syntax

setFromHex(string)

Parameter

string

Ein hexadezimaler String, der Bytes kodiert, die in ein Uint8Array geschrieben 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 (Groß-/Kleinschreibung wird nicht unterschieden) einschließt.
Keine Leerzeichen enthalten (im Gegensatz zu Uint8Array.prototype.setFromBase64()).

Beachten Sie, dass der String nur bis zu dem Punkt gelesen wird, an dem das Array gefüllt ist, daher wird ungültige Hex-Syntax nach diesem Punkt ignoriert.

Rückgabewert

Ein Objekt, das die folgenden Eigenschaften enthält:

read

Die Anzahl der hexadezimalen Zeichen, die aus dem Eingabestring gelesen wurden. Wenn die dekodierten Daten in das Array passen, entspricht dies der Länge des Eingabestrings: andernfalls ist es die Anzahl der vollständigen hexadezimalen Zeichen, die in das Array passen.

written

Die Anzahl der Bytes, die in das Uint8Array geschrieben wurden. Wird niemals größer als die byteLength dieses Uint8Array sein.

Ausnahmen

SyntaxError

Wird ausgelöst, wenn der Eingabestring Zeichen außerhalb des Hex-Alphabets enthält oder seine Länge ungerade ist.

TypeError

Wird ausgelöst, wenn der Eingabestring kein String ist.

Beispiele

Entschlüsseln eines hexadezimalen Strings

Dieses Beispiel entschlüsselt einen hexadezimalen String in ein vorhandenes Uint8Array.

js
const uint8Array = new Uint8Array(8);
const result = uint8Array.setFromHex("cafed00d");
console.log(result); // { read: 8, written: 4 }
console.log(uint8Array); // Uint8Array(8) [202, 254, 208, 13, 0, 0, 0, 0]

Entschlüsseln eines großen Strings in ein kleines Array

Wenn der String mehr Daten enthält, als das Array aufnehmen kann, schreibt die Methode nur so viele Bytes, wie das Array aufnehmen kann.

js
const uint8Array = new Uint8Array(4);
const result = uint8Array.setFromHex("cafed00d-some random stuff");
console.log(result); // { read: 8, written: 4 }
console.log(uint8Array); // Uint8Array(4) [202, 254, 208, 13]

Überschüssige Zeichen werden ignoriert, auch wenn sie ungültig sind. Die Gesamtlänge des Eingabestrings muss jedoch gerade sein.

Festlegen von Daten an einem bestimmten Offset

Die setFromHex()-Methode beginnt immer am Anfang des Uint8Array zu schreiben. Wenn Sie in die Mitte des Arrays schreiben möchten, können Sie stattdessen in ein TypedArray.prototype.subarray() schreiben.

js
const uint8Array = new Uint8Array(8);
// Start writing at offset 2
const result = uint8Array.subarray(2).setFromHex("cafed00d");
console.log(result); // { read: 8, written: 4 }
console.log(uint8Array);
// Uint8Array(8) [0, 0, 202, 254, 208, 13, 0, 0]

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Uint8Array
Konstruktor
1. Uint8Array()
Statische Methoden
1. fromBase64()
2. fromHex()
Instanzmethoden
1. setFromBase64()
2. setFromHex()
3. toBase64()
4. toHex()
Vererbung
TypedArray
Statische Methoden
1. from()
2. of()
Statische Eigenschaften
1. BYTES_PER_ELEMENT
2. [Symbol.species]
Instanzmethoden
1. at()
2. copyWithin()
3. entries()
4. every()
5. fill()
6. filter()
7. find()
8. findIndex()
9. findLast()
10. findLastIndex()
11. forEach()
12. includes()
13. indexOf()
14. join()
15. keys()
16. lastIndexOf()
17. map()
18. reduce()
19. reduceRight()
20. reverse()
21. set()
22. slice()
23. some()
24. sort()
25. subarray()
26. toLocaleString()
27. toReversed()
28. toSorted()
29. toString()
30. values()
31. with()
32. [Symbol.iterator]()
Instanzeigenschaften
1. buffer
2. byteLength
3. byteOffset
4. length
Object/Function
Statische Methoden
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Statische Eigenschaften
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Instanzmethoden
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
Instanzeigenschaften
1. __proto__
2. constructor
Verwandte Seiten
BigInt64Array
BigUint64Array
Float16Array
Float32Array
Float64Array
Int8Array
Int16Array
Int32Array
Uint8ClampedArray
Uint16Array
Uint32Array