Qué incluye el paquete
base64hub es un módulo ES con cuatro funciones y sin dependencias. Funciona en Node.js 18 y posteriores.
| Función | Devuelve |
|---|---|
encode(bytesOrString, { url, pad, wrap }) | texto Base64; las cadenas se codifican antes como UTF-8 |
decode(string) | un Uint8Array; lanza una excepción si la entrada no es válida |
validate(string) | { valid, variant, padded, bytes }, o { valid: false, error } |
dataUri(bytes, mime?) | un URI data:; si no indicas el tipo MIME, se detecta |
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 acepta lo que la gente pega en la práctica: saltos de línea, espacios, la falta del relleno =, un prefijo data:...;base64, y cualquiera de los dos alfabetos. Rechaza todo lo demás, como un ! suelto, un = en medio o una longitud que no puede ser Base64.
El comando b64 desde npm
La instalación global añade el comando b64, la misma herramienta que la CLI nativa, con las mismas opciones y códigos de salida:
$ npm i -g base64hub
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 -d SGVsbG8sIGh1YiE=
Hello, hub!
La versión de npm lee toda la entrada en memoria antes de procesarla. Para archivos de varios gigabytes usa la versión de Go, que trabaja en flujo. La documentación de npm recoge todas las opciones.
base64hub frente a Buffer, btoa y atob
Node.js ya trae Base64 integrado, y para datos de confianza basta. Las diferencias aparecen con entradas que no has generado tú. Estas líneas se ejecutaron en 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 | |
|---|---|---|---|
| Texto Unicode | sí | solo Latin-1 | sí, como UTF-8 |
| Alfabeto URL-safe | codificación "base64url" | no | { url: true }, y se acepta al decodificar |
| Caracteres no válidos | se omiten sin aviso | error | error con posición |
| Validación | no | no | validate() |
URI data: | no | no | dataUri(), y se quita al decodificar |
Los entornos de ejecución más recientes también añaden Uint8Array.prototype.toBase64(); esta guía explica dónde funciona. Para más fragmentos de Node.js sin ningún paquete, consulta Base64 en Node.js.
Por qué importa no tener dependencias
Una utilidad de Base64 está en el camino de tokens, claves y subidas de archivos, así que es un mal sitio para un árbol de dependencias largo. El paquete solo usa módulos integrados de Node.js, su núcleo Base64 ocupa unas cien líneas y sus pruebas ejecutan los vectores de prueba compartidos que también superan la CLI, el paquete de Python y la API.
Preguntas frecuentes
¿Cómo instalo una CLI de Base64 con npm?
npm i -g base64hub instala el comando b64 de forma global. Para probarlo una vez sin instalar nada, ejecuta npx base64hub "Hello, hub!".
¿El paquete base64hub funciona con require()?
Es un módulo ES, así que cárgalo con import { encode } from "base64hub". En un archivo CommonJS usa un await import("base64hub") dinámico.
¿Para qué usar un paquete si Node.js ya tiene Buffer?
Buffer.from(text, "base64") se salta los caracteres que no entiende, así que una entrada dañada se convierte en bytes incorrectos sin ningún error. decode() de base64hub la rechaza e indica la posición, y validate() te dice el alfabeto y el tamaño antes de decodificar.
¿Cómo codifico un archivo en Base64 en Node.js con base64hub?
Lee los bytes y pásalos: encode(await readFile("logo.png")), con readFile de node:fs/promises. Para obtener directamente una cadena data:image/png;base64,…, llama a dataUri() con los mismos bytes.