Uint8Array.prototype.toBase64()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die toBase64()-Methode von Uint8Array-Instanzen gibt einen Base64-codierten String basierend auf den Daten in diesem Uint8Array-Objekt zurück.

Diese Methode sollte gegenüber Window.btoa() bevorzugt werden, insbesondere wenn Sie bereits ein Uint8Array haben, da Sie es nicht zuerst in einen String konvertieren müssen.

Syntax

toBase64()
toBase64(options)

Parameter

options Optional

Ein Objekt zur Anpassung des Base64-String-Formats. 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): Kodiert die Eingabe mit dem Standard-Base64-Alphabet, das + und / verwendet.
"base64url": Kodiert die Eingabe mit dem URL-sicheren Base64-Alphabet, das - und _ verwendet.

omitPadding Optional

Ein Boolescher Wert, der angibt, ob Füllzeichen (=) am Ende des Base64-Strings weggelassen werden sollen. Der Standardwert ist false.

Rückgabewert

Ein Base64-codierter String, der die Daten im Uint8Array darstellt.

Ausnahmen

TypeError

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

Das options-Objekt ist kein Objekt oder undefined.
Das options.alphabet ist nicht der erwartete Wert oder undefined.

Beispiele

Binärdaten kodieren

Dieses Beispiel verwendet die Standardoptionen alphabet und omitPadding, um Daten aus einem Uint8Array in einen Base64-String zu kodieren.

const uint8Array = new Uint8Array([29, 233, 101, 161]);
console.log(uint8Array.toBase64()); // "HelloQ=="

Daten ohne Auffüllung kodieren

const uint8Array = new Uint8Array([29, 233, 101, 161]);
console.log(uint8Array.toBase64({ omitPadding: true })); // "HelloQ"

Daten mit URL-sicherem Alphabet kodieren

In diesem Beispiel wird ein URLSearchParams-Objekt mit einem Base64-codierten String unter Verwendung des URL-sicheren Alphabets gefüllt.

const uint8Array = new Uint8Array([46, 139, 222, 255, 42, 46]);
const base64 = uint8Array.toBase64({ alphabet: "base64url" });
const params = new URLSearchParams();
params.set("data", base64);
console.log(params.toString()); // "data=Love_you"

Stream-Kodierung

Dieses Beispiel ist aus dem Originalvorschlag adaptiert und zeigt, wie Streaming im Nutzerland implementiert werden kann. Es imitiert die TextEncoder-API mit der Option stream.

class Base64Encoder {
  #extra;
  #extraLength;
  constructor() {
    this.#extra = new Uint8Array(3);
    this.#extraLength = 0;
  }

  // Partly derived from https://github.com/lucacasonato/base64_streams/blob/main/src/iterator/encoder.ts
  encode(chunk = Uint8Array.of(), options = {}) {
    const stream = options.stream ?? false;

    if (this.#extraLength > 0) {
      const bytesNeeded = 3 - this.#extraLength;
      const bytesAvailable = Math.min(bytesNeeded, chunk.length);
      this.#extra.set(chunk.subarray(0, bytesAvailable), this.#extraLength);
      chunk = chunk.subarray(bytesAvailable);
      this.#extraLength += bytesAvailable;
    }

    if (!stream) {
      // assert: this.#extraLength.length === 0 || this.#extraLength === 3 || chunk.length === 0
      const prefix = this.#extra.subarray(0, this.#extraLength).toBase64();
      this.#extraLength = 0;
      return prefix + chunk.toBase64();
    }

    let extraReturn = "";

    if (this.#extraLength === 3) {
      extraReturn = this.#extra.toBase64();
      this.#extraLength = 0;
    }

    const remainder = chunk.length % 3;
    if (remainder > 0) {
      this.#extra.set(chunk.subarray(chunk.length - remainder));
      this.#extraLength = remainder;
      chunk = chunk.subarray(0, chunk.length - remainder);
    }

    return extraReturn + chunk.toBase64();
  }
}

const encoder = new Base64Encoder();

console.log(
  encoder.encode(Uint8Array.of(72, 101, 108, 108, 111), { stream: true }),
);
// "SGVs"
console.log(
  encoder.encode(Uint8Array.of(32, 87, 111, 114, 108, 100), { stream: true }),
);
// "bG8gV29y"
console.log(encoder.encode());
// "bGQ="

Spezifikationen

Specification
Uint8Array to/from base64 # sec-uint8array.prototype.tobase64