Referencia del paquete npm
base64hub es un módulo ES para Node.js 18 y posteriores con cuatro funciones, tipos de TypeScript y el comando b64. Sin dependencias.
Instalación
npm i base64hub # library
npm i -g base64hub # b64 command
El paquete es solo ESM. Impórtalo con import; desde CommonJS usa await import("base64hub"). Incluye las definiciones de tipos.
import { encode, decode, validate, dataUri, Base64Error } from "base64hub";
encode(input, options?)
Codifica bytes, o los bytes UTF-8 de una cadena, y devuelve una cadena. input puede ser una cadena, un Uint8Array (un Buffer de Node.js lo es), un ArrayBuffer o cualquier vista de array tipado.
| Opción | Tipo | Por defecto | Efecto |
|---|---|---|---|
url | boolean | false | Alfabeto URL-safe (- y _). |
pad | boolean | true | Añade el relleno =. |
wrap | number | 0 | Inserta \n cada N caracteres, ninguno al final; 76 es 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)
Decodifica Base64 a un Uint8Array. Acepta espacios, tabuladores y saltos de línea, un prefijo data:...;base64,, la falta de relleno y los dos alfabetos. Cualquier otra cosa lanza un Base64Error cuya propiedad position es el índice, contado desde 0, del carácter incorrecto en la entrada limpia.
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
}
Usa new TextDecoder().decode(bytes) para obtener texto y Buffer.from(bytes) cuando otra API de Node.js quiera un Buffer.
validate(text)
Comprueba un texto sin lanzar excepciones. Es válido exactamente cuando decode tendría éxito.
validate("SGVsbG8sIGh1YiE");
// { valid: true, variant: 'either', padded: false, bytes: 11 }
validate("Zm9v!");
// { valid: false, error: "invalid character '!' at position 4" }
| Campo | Significado |
|---|---|
valid | true o false. |
variant | standard (aparece + o /), url (aparece - o _), mixed (ambos) o either (ninguno). |
padded | La longitud limpia, = incluidos, es múltiplo de 4. |
bytes | Tamaño decodificado en bytes. |
error | Solo con entrada no válida: el motivo, el mismo texto que lanzaría decode. |
dataUri(input, mime?)
Construye una cadena data:<mime>;base64,<payload>: alfabeto estándar, con relleno, sin cortes de línea. Sin mime el tipo se detecta: PNG, JPEG, GIF, WebP, PDF y SVG por su firma, text/plain;charset=utf-8 para texto UTF-8 y, si no, 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..."
El comando b64
npm i -g base64hub instala b64, y npx base64hub "Hello, hub!" lo ejecuta una vez sin instalarlo. Las opciones, los mensajes y los códigos de salida coinciden con la referencia de la CLI. La versión de npm lee toda la entrada en memoria antes de procesarla; para archivos muy grandes usa la versión de Go.
Actualizado 22 nov 2026