Was das Paket enthält
base64hub ist ein ES-Modul mit vier Funktionen und ohne Abhängigkeiten. Es läuft ab Node.js 18.
| Funktion | Rü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)
Buffer | btoa / atob | base64hub | |
|---|---|---|---|
| Unicode-Text | ja | nur Latin-1 | ja, als UTF-8 |
| URL-sicheres Alphabet | Kodierung "base64url" | nein | { url: true }, beim Dekodieren akzeptiert |
| Ungültige Zeichen | still übersprungen | Fehler | Fehler mit Position |
| Validierung | nein | nein | validate() |
data:-URIs | nein | nein | dataUri(), 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.