Uint8Array.fromBase64()

string

Ein Base64-String, der Bytes kodiert, um in ein Uint8Array umgewandelt zu werden. Der String darf nur Zeichen im Base64-Alphabet enthalten, das A–Z, a–z, 0–9 und zwei Sonderzeichen umfasst, die entweder + und / (wenn alphabet: "base64" in options verwendet wird) oder - und _ (wenn alphabet: "base64url" in options verwendet wird) sind. Am Ende können Auffüllzeichen = vorhanden sein. Alle ASCII-Leerzeichen innerhalb des Strings werden ignoriert.

options Optional

Ein Objekt zur Anpassung des Prozesses der Base64-String-Interpretation. Es kann die folgenden Eigenschaften enthalten:

alphabet Optional

Ein String, der das zu verwendende Base64-Alphabet angibt. Es kann einer der folgenden sein:

"base64" (Standard)

Akzeptiert Eingaben, die mit dem standardmäßigen Base64-Alphabet kodiert sind, das + und / verwendet.

"base64url"

Akzeptiert Eingaben, die mit dem URL-sicheren Base64-Alphabet kodiert sind, das - und _ verwendet.

lastChunkHandling Optional

Ein String, der angibt, wie der letzte Abschnitt des Base64-Strings behandelt werden soll. Da alle 4 Zeichen in Base64 3 Bytes kodieren, wird der String in Abschnitte mit 4 Zeichen unterteilt. Wenn der letzte Abschnitt weniger als 4 Zeichen hat, muss er anders behandelt werden. Es kann einer der folgenden sein:

"loose" (Standard)

Der letzte Abschnitt kann entweder 2 oder 3 Base64-Zeichen oder genau 4 Zeichen mit Auffüllzeichen = sein. Der letzte Abschnitt wird dekodiert und dem Ergebnis hinzugefügt.

"strict"

Der letzte Abschnitt muss genau 4 Zeichen lang sein mit Auffüllzeichen =. Darüber hinaus müssen Überlauf-Bits (nachlaufende Bits aus dem letzten Base64-Zeichen, die keine Daten darstellen) 0 sein. Der letzte Abschnitt wird dekodiert und dem Ergebnis hinzugefügt.

"stop-before-partial"

Wenn der letzte Abschnitt genau 4 Zeichen lang mit Auffüllzeichen = ist, wird er dekodiert und dem Ergebnis hinzugefügt. Andernfalls wird der letzte partielle Abschnitt ignoriert (aber wenn er ein Base64-Zeichen gefolgt von = enthält, wird dennoch ein Syntaxfehler ausgelöst). Dies ist nützlich, wenn der String aus einem Stream stammt und der letzte Abschnitt noch nicht vollständig ist. Um zu wissen, wie viele Zeichen der Eingabe gelesen wurden, verwenden Sie stattdessen Uint8Array.prototype.setFromBase64() (die verlinkte Seite enthält auch ein Beispiel zur Stream-Dekodierung unter Verwendung von "stop-before-partial").

Ein neues Uint8Array-Objekt, das die dekodierten Bytes aus dem Base64-kodierten String enthält.

SyntaxError

Wird ausgelöst, wenn der Eingabestring Zeichen außerhalb des angegebenen Alphabets enthält oder wenn der letzte Abschnitt die lastChunkHandling-Option nicht erfüllt.

TypeError

Wird in einem der folgenden Fälle ausgelöst:

• Der Eingabestring ist kein String.
• Das options-Objekt ist kein Objekt oder undefined.
• Die Optionen haben nicht die erwarteten Werte oder sind undefined.

Dieses Beispiel verwendet die Standardoptionen alphabet und lastChunkHandling um einen Base64-String zu dekodieren. Beachten Sie:

• Das Leerzeichen im String wird ignoriert.
• Der String hat 14 Base64-Zeichen, nicht ein Vielfaches von 4. Dies ist nur mit lastChunkHandling: "loose" gültig und dekodierbar.
• Der letzte Abschnitt, Ph, endet mit dem Zeichen h, das in Base64 0b100001 ist, sodass die letzten 0001 Bits "Überlauf-Bits" sind und ignoriert werden. Dies ist nur mit lastChunkHandling: "loose" gültig und dekodierbar.

const uint8Array = Uint8Array.fromBase64("PGI+ TURO PC9i Ph");
console.log(uint8Array); // Uint8Array(10) [60, 98, 62, 77, 68, 78, 60, 47, 98, 62]

Dieses Beispiel verwendet die alphabet-Option, um einen URL-sicheren Base64-String zu dekodieren.

const uint8Array = Uint8Array.fromBase64("PGI-TUROPC9iPg", {
  alphabet: "base64url",
});
console.log(uint8Array); // Uint8Array(10) [60, 98, 62, 77, 68, 78, 60, 47, 98, 62]

Dieses Beispiel verwendet die lastChunkHandling-Option, um einen Base64-String zu dekodieren, bei dem der letzte Abschnitt genau 4 Zeichen lang mit Auffüllzeichen = sein muss, und die Überlauf-Bits müssen 0 sein.

const array1 = Uint8Array.fromBase64("PGI+ TURO PC9i Pg==", {
  lastChunkHandling: "strict",
});
console.log(array1); // Uint8Array(10) [60, 98, 62, 77, 68, 78, 60, 47, 98, 62]

const array2 = Uint8Array.fromBase64("PGI+ TURO PC9i Ph==", {
  lastChunkHandling: "strict",
});
// Throws a SyntaxError because h is 0b100001, where the last 4 bits are not 0

const array3 = Uint8Array.fromBase64("PGI+ TURO PC9i Pg", {
  lastChunkHandling: "strict",
});
// Throws a SyntaxError because the last chunk is not exactly 4 characters long

Dieses Beispiel verwendet die lastChunkHandling-Option, um einen Base64-String zu dekodieren und dabei jeden partiellen letzten Abschnitt zu ignorieren.

// The last chunk is complete
const array1 = Uint8Array.fromBase64("PGI+ TURO PC9i", {
  lastChunkHandling: "stop-before-partial",
});
console.log(array1); // Uint8Array(9) [60, 98, 62, 77, 68, 78, 60, 47, 98]

// The last chunk is also complete with padding
const array2 = Uint8Array.fromBase64("PGI+ TURO PC9i Pg==", {
  lastChunkHandling: "stop-before-partial",
});
console.log(array2); // Uint8Array(10) [60, 98, 62, 77, 68, 78, 60, 47, 98, 62]

// The last chunk is partial; it's ignored
const array3 = Uint8Array.fromBase64("PGI+ TURO PC9i Pg", {
  lastChunkHandling: "stop-before-partial",
});
console.log(array3); // Uint8Array(9) [60, 98, 62, 77, 68, 78, 60, 47, 98]

// The last chunk is partial with padding; it's still ignored
const array4 = Uint8Array.fromBase64("PGI+ TURO PC9i Pg=", {
  lastChunkHandling: "stop-before-partial",
});
console.log(array4); // Uint8Array(9) [60, 98, 62, 77, 68, 78, 60, 47, 98]

// The last chunk is partial, but it contains one base64 character followed by `=`
const array5 = Uint8Array.fromBase64("PGI+ TURO PC9i P=", {
  lastChunkHandling: "stop-before-partial",
});
// Throws a SyntaxError because this cannot possibly be part of a valid base64 string

• Polyfill von Uint8Array.fromBase64 in core-js
• Uint8Array
• Uint8Array.prototype.setFromBase64()
• Uint8Array.prototype.toBase64()
• Window.atob()