Charger un fichier
  1. base64hub
  2. Téléchargement
  3. Paquet npm
v1.0.0 · Open source · MIT

base64hub sur npm : bibliothèque et CLI Base64 pour Node.js

npm i base64hub apporte à Node.js une petite bibliothèque Base64 aux erreurs strictes, avec sortie URL-safe, et la même commande b64 que les versions natives.

npm i base64hub
Gratuit sans compte, sans clé MIT licence open source Zéro dépendance à l’exécution Mis à jour 22 nov. 2026

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.

FonctionRenvoie
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)
Bufferbtoa / atobbase64hub
Texte UnicodeouiLatin-1 uniquementoui, en UTF-8
Alphabet URL-safeencodage "base64url"non{ url: true }, et accepté au décodage
Caractères invalidesignorés sans avertissementerreurerreur avec position
Validationnonnonvalidate()
URI data:nonnondataUri(), 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.

Autres outils base64hub