Datei hochladen
  1. base64hub
  2. Download
  3. npm-Paket
v1.0.0 · Open Source · MIT

base64hub auf npm: Base64-Bibliothek und CLI für Node.js

npm i base64hub gibt Node.js eine kleine Base64-Bibliothek mit strengen Fehlern und URL-sicherer Ausgabe, dazu dasselbe Kommandozeilentool b64 wie die nativen Builds.

npm i base64hub
Kostenlos ohne Konto, ohne Schlüssel MIT Open-Source-Lizenz Null Laufzeitabhängigkeiten Aktualisiert 22.11.2026

Was das Paket enthält

base64hub ist ein ES-Modul mit vier Funktionen und ohne Abhängigkeiten. Es läuft ab Node.js 18.

FunktionRückgabe
encode(bytesOrString, { url, pad, wrap })Base64-Text; Strings werden zuerst als UTF-8 kodiert
decode(string)ein Uint8Array; wirft bei ungültiger Eingabe einen Fehler
validate(string){ valid, variant, padded, bytes } oder { valid: false, error }
dataUri(bytes, mime?)eine data:-URI; ohne Angabe wird der MIME-Typ erkannt
npm i base64hub
import { encode, decode, validate, dataUri } from "base64hub";

encode("Hello, hub!");                              // "SGVsbG8sIGh1YiE="
encode("Привет", { url: true, pad: false });        // "0J_RgNC40LLQtdGC"
new TextDecoder().decode(decode("SGVsbG8sIGh1YiE")); // "Hello, hub!"
validate("-_-_").variant;                           // "url"
dataUri(new TextEncoder().encode("Hi"));            // "data:text/plain;charset=utf-8;base64,SGk="

decode akzeptiert, was in der Praxis eingefügt wird: Zeilenumbrüche, Leerzeichen, fehlendes =-Padding, ein Präfix data:...;base64, und beide Alphabete. Alles andere lehnt es ab, etwa ein verirrtes !, ein = in der Mitte oder eine Länge, die kein Base64 sein kann.

Der Befehl b64 aus npm

Die globale Installation fügt den Befehl b64 hinzu, dasselbe Tool wie das native CLI mit denselben Flags und Exit-Codes:

$ npm i -g base64hub
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!

Der npm-Build liest die gesamte Eingabe in den Speicher, bevor er sie verarbeitet. Für Dateien mit mehreren Gigabyte nehmen Sie den Go-Build, der streamt. Die npm-Doku listet jede Option.

base64hub im Vergleich zu Buffer, btoa und atob

Node.js hat Base64 bereits eingebaut, und für vertrauenswürdige Daten genügt das. Die Unterschiede zeigen sich bei Eingaben, die Sie nicht selbst erzeugt haben. Diese Zeilen wurden unter Node.js 24 ausgeführt:

Buffer.from("Zm9v!YmFy", "base64").toString(); // "foobar", the "!" is skipped silently
btoa("Привет");                                  // throws InvalidCharacterError (Latin-1 only)
atob("-_-_");                                    // throws InvalidCharacterError (no URL-safe)
Bufferbtoa / atobbase64hub
Unicode-Textjanur Latin-1ja, als UTF-8
URL-sicheres AlphabetKodierung "base64url"nein{ url: true }, beim Dekodieren akzeptiert
Ungültige Zeichenstill übersprungenFehlerFehler mit Position
Validierungneinneinvalidate()
data:-URIsneinneindataUri(), beim Dekodieren entfernt

Neuere Runtimes bringen außerdem Uint8Array.prototype.toBase64() mit; diese Anleitung zeigt, wo es funktioniert. Weitere Node.js-Beispiele ganz ohne Paket finden Sie unter Base64 in Node.js.

Warum null Abhängigkeiten hier zählen

Ein Base64-Helfer sitzt im Weg von Tokens, Schlüsseln und Datei-Uploads und ist damit ein schlechter Ort für einen langen Abhängigkeitsbaum. Das Paket nutzt nur Built-ins von Node.js, sein Base64-Kern umfasst etwa hundert Zeilen, und seine Tests laufen über dieselben gemeinsamen Testvektoren, die auch das CLI, das Python-Paket und die API bestehen.

Häufige Fragen

Wie installiere ich ein Base64-CLI mit npm?

npm i -g base64hub installiert den Befehl b64 global. Um ihn einmal ohne Installation auszuprobieren, führen Sie npx base64hub "Hello, hub!" aus.

Funktioniert das Paket base64hub mit require()?

Es ist ein ES-Modul, laden Sie es also mit import { encode } from "base64hub". In einer CommonJS-Datei verwenden Sie ein dynamisches await import("base64hub").

Wozu ein Paket, wenn Node.js doch Buffer hat?

Buffer.from(text, "base64") überspringt Zeichen, die es nicht versteht, beschädigte Eingaben werden so ohne Fehler zu falschen Bytes. decode() aus base64hub lehnt sie ab und meldet die Position, und validate() nennt Ihnen Alphabet und Größe, bevor Sie dekodieren.

Wie kodiere ich mit base64hub eine Datei in Node.js in Base64?

Lesen Sie die Bytes und übergeben Sie sie: encode(await readFile("logo.png")) mit readFile aus node:fs/promises. Für einen fertigen String data:image/png;base64,… rufen Sie dataUri() mit denselben Bytes auf.

Mehr von base64hub