Charger un fichier
  1. base64hub
  2. Docs
  3. Paquet npm

Référence du paquet npm

base64hub est un module ES pour Node.js 18 et ultérieur, avec quatre fonctions, des types TypeScript et la commande b64. Aucune dépendance.

Installation

npm i base64hub        # library
npm i -g base64hub     # b64 command

Le paquet est uniquement ESM. Importez-le avec import ; depuis CommonJS, utilisez await import("base64hub"). Les définitions de types sont incluses.

import { encode, decode, validate, dataUri, Base64Error } from "base64hub";

encode(input, options?)

Encode des octets, ou les octets UTF-8 d’une chaîne, et renvoie une chaîne. input peut être une chaîne, un Uint8Array (un Buffer de Node.js en est un), un ArrayBuffer ou n’importe quelle vue de tableau typé.

OptionTypePar défautEffet
urlbooleanfalseAlphabet URL-safe (- et _).
padbooleantrueAjoute le remplissage =.
wrapnumber0Insère \n tous les N caractères, jamais à la fin ; 76 correspond à MIME.
encode("Hello, hub!");                        // "SGVsbG8sIGh1YiE="
encode("Привет", { url: true, pad: false });  // "0J_RgNC40LLQtdGC"
encode("foobar", { wrap: 4 });                // "Zm9v\nYmFy"
encode(new Uint8Array([0xfb, 0xff, 0xbf]));   // "+/+/"

decode(text)

Décode du Base64 en Uint8Array. Les espaces, tabulations et sauts de ligne, un préfixe data:...;base64,, le remplissage manquant et les deux alphabets sont acceptés. Tout le reste lève une Base64Error dont la propriété position est l’indice, à partir de 0, du caractère fautif dans l’entrée nettoyée.

decode("+/+/");                                      // Uint8Array(3) [ 251, 255, 191 ]
new TextDecoder().decode(decode("SGVsbG8sIGh1YiE")); // "Hello, hub!"

try {
  decode("Zm9v!");
} catch (e) {
  if (e instanceof Base64Error) console.log(e.message, e.position);
  // invalid character '!' at position 4 4
}

Utilisez new TextDecoder().decode(bytes) pour obtenir du texte, et Buffer.from(bytes) quand une autre API de Node.js attend un Buffer.

validate(text)

Vérifie un texte sans lever d’exception. Le résultat est valide exactement quand decode réussirait.

validate("SGVsbG8sIGh1YiE");
// { valid: true, variant: 'either', padded: false, bytes: 11 }
validate("Zm9v!");
// { valid: false, error: "invalid character '!' at position 4" }
ChampSignification
validtrue ou false.
variantstandard (+ ou / rencontré), url (- ou _ rencontré), mixed (les deux) ou either (aucun).
paddedLa longueur nettoyée, = compris, est un multiple de 4.
bytesTaille décodée en octets.
errorSeulement pour une entrée invalide : la raison, le même texte que l’exception de decode.

dataUri(input, mime?)

Construit une chaîne data:<mime>;base64,<payload> : alphabet standard, avec remplissage, jamais coupée. Sans mime, le type est détecté : PNG, JPEG, GIF, WebP, PDF et SVG d’après leur signature, text/plain;charset=utf-8 pour du texte UTF-8, sinon application/octet-stream.

dataUri("Hi");                 // "data:text/plain;charset=utf-8;base64,SGk="
dataUri("a,b", "text/csv");    // "data:text/csv;base64,YSxi"

import { readFile } from "node:fs/promises";
dataUri(await readFile("logo.png")); // "data:image/png;base64,iVBORw0KGgo..."

La commande b64

npm i -g base64hub installe b64, et npx base64hub "Hello, hub!" le lance une fois sans installation. Options, messages et codes de sortie correspondent à la référence de la CLI. La version npm charge toute l’entrée en mémoire avant de la traiter ; pour de très gros fichiers, utilisez la version Go.

Mis à jour 22 nov. 2026