Uint8Array.fromBase64()

string

Ein Base64-String, der Bytes codiert, um ihn in ein Uint8Array zu konvertieren. Der String darf nur Zeichen aus dem Base64-Alphabet enthalten, das A–Z, a–z, 0–9 sowie zwei Sonderzeichen umfasst, die entweder + und / (bei Verwendung von alphabet: "base64" in options) oder - und _ (bei Verwendung von alphabet: "base64url" in options) sind. Am Ende können = als Füllzeichen vorhanden sein. Alle ASCII-Leerzeichen im String werden ignoriert.

options Optional

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

alphabet Optional

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

"base64" (Standard)

Akzeptiert Eingaben, die mit dem Standard-Base64-Alphabet codiert sind, das + und / verwendet.

"base64url"

Akzeptiert Eingaben, die mit dem URL-sicheren Base64-Alphabet codiert 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 codieren, wird der String in Abschnitte von 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 enthalten oder genau 4 Zeichen lang mit = als Füllzeichen sein. Der letzte Abschnitt wird decodiert und dem Ergebnis hinzugefügt.

"strict"

Der letzte Abschnitt muss genau 4 Zeichen lang mit = als Füllzeichen sein. Ferner müssen die Überlaufbits (nachgestellte Bits des letzten Base64-Zeichens, die keine Daten darstellen) 0 sein. Der letzte Abschnitt wird decodiert und dem Ergebnis hinzugefügt.

"stop-before-partial"

Wenn der letzte Abschnitt genau 4 Zeichen lang mit = als Füllzeichen ist, wird er decodiert und dem Ergebnis hinzugefügt. Andernfalls wird der letzte unvollständige Abschnitt ignoriert (aber wenn er ein Base64-Zeichen gefolgt von = enthält, wird trotzdem ein Syntaxfehler ausgelöst). Dies ist nützlich, wenn der String aus einem Stream kommt und der letzte Abschnitt noch nicht vollständig ist. Um zu erfahren, wie viele Zeichen der Eingabe gelesen wurden, verwenden Sie stattdessen Uint8Array.prototype.setFromBase64() (die verlinkte Seite enthält auch ein Beispiel für die Decoder aus Streams mit "stop-before-partial").

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

SyntaxError

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

TypeError

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

• Der Eingabe-String 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 standardmäßigen alphabet und lastChunkHandling Optionen, um einen Base64-String zu decodieren. Beachten Sie:

• Das Leerzeichen im Raum wird ignoriert.
• Der String hat 14 Base64-Zeichen, was kein Vielfaches von 4 ist. Dies ist nur mit lastChunkHandling: "loose" gültig und decodierbar.
• Der letzte Abschnitt, Ph, endet mit dem Zeichen h, das in Base64 0b100001 ist, daher werden die letzten 0001 Bits als "Überlaufbits" ignoriert. Dies ist nur mit lastChunkHandling: "loose" gültig und decodierbar.

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 decodieren.

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 decodieren, bei dem der letzte Abschnitt genau 4 Zeichen lang mit Füllzeichen = sein muss und die Überlaufbits 0 sein müssen.

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 decodieren und dabei einen unvollständigen 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
• es-shims polyfill von Uint8Array.fromBase64
• Uint8Array
• Uint8Array.prototype.setFromBase64()
• Uint8Array.prototype.toBase64()
• Window.atob()