Ce que contient le paquet
base64hub est un module ES de quatre fonctions, sans aucune dépendance. Il fonctionne avec Node.js 18 et versions ultérieures.
| Fonction | Renvoie |
|---|---|
encode(bytesOrString, { url, pad, wrap }) | du texte Base64 ; les chaînes sont d’abord encodées en UTF-8 |
decode(string) | un Uint8Array ; lève une exception si l’entrée est invalide |
validate(string) | { valid, variant, padded, bytes }, ou { valid: false, error } |
dataUri(bytes, mime?) | une URI data: ; le type MIME est détecté si vous l’omettez |
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 accepte ce que l’on colle en pratique : sauts de ligne, espaces, remplissage = manquant, préfixe data:...;base64, et les deux alphabets. Il refuse tout le reste, comme un ! égaré, un = au milieu ou une longueur impossible pour du Base64.
La commande b64 via npm
L’installation globale ajoute la commande b64, le même outil que la CLI native, avec les mêmes options et les mêmes codes de sortie :
$ npm i -g base64hub
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!
La version npm charge toute l’entrée en mémoire avant de la traiter. Pour des fichiers de plusieurs gigaoctets, utilisez la version Go, qui travaille en flux. La documentation npm liste toutes les options.
base64hub, Buffer, btoa et atob
Node.js intègre déjà Base64, et pour des données de confiance cela suffit. Les différences apparaissent avec des entrées que vous n’avez pas produites vous-même. Ces lignes ont été exécutées sous Node.js 24 :
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 | |
|---|---|---|---|
| Texte Unicode | oui | Latin-1 uniquement | oui, en UTF-8 |
| Alphabet URL-safe | encodage "base64url" | non | { url: true }, et accepté au décodage |
| Caractères invalides | ignorés sans avertissement | erreur | erreur avec position |
| Validation | non | non | validate() |
URI data: | non | non | dataUri(), et retirées au décodage |
Les environnements récents ajoutent aussi Uint8Array.prototype.toBase64() ; ce guide indique où il fonctionne. Pour d’autres extraits Node.js sans aucun paquet, voir Base64 en Node.js.
Pourquoi zéro dépendance compte ici
Un utilitaire Base64 se trouve sur le chemin des jetons, des clés et des fichiers envoyés : c’est un mauvais endroit pour un long arbre de dépendances. Le paquet n’utilise que les modules intégrés de Node.js, son cœur Base64 tient en une centaine de lignes, et ses tests passent les vecteurs de test communs que réussissent aussi la CLI, le paquet Python et l’API.
FAQ
Comment installer une CLI Base64 avec npm ?
npm i -g base64hub installe la commande b64 globalement. Pour l’essayer une fois sans l’installer, lancez npx base64hub "Hello, hub!".
Le paquet base64hub fonctionne-t-il avec require() ?
C’est un module ES : chargez-le avec import { encode } from "base64hub". Dans un fichier CommonJS, utilisez un await import("base64hub") dynamique.
Pourquoi un paquet alors que Node.js a déjà Buffer ?
Buffer.from(text, "base64") saute les caractères qu’il ne comprend pas : une entrée abîmée donne de mauvais octets sans la moindre erreur. decode() de base64hub la rejette et indique la position, et validate() vous donne l’alphabet et la taille avant le décodage.
Comment encoder un fichier en Base64 sous Node.js avec base64hub ?
Lisez les octets et passez-les à la fonction : encode(await readFile("logo.png")), avec readFile importé de node:fs/promises. Pour obtenir directement une chaîne data:image/png;base64,…, appelez dataUri() sur les mêmes octets.