Subir un archivo
  1. base64hub
  2. Docs
  3. Paquete npm

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ónTipoPor defectoEfecto
urlbooleanfalseAlfabeto URL-safe (- y _).
padbooleantrueAñade el relleno =.
wrapnumber0Inserta \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" }
CampoSignificado
validtrue o false.
variantstandard (aparece + o /), url (aparece - o _), mixed (ambos) o either (ninguno).
paddedLa longitud limpia, = incluidos, es múltiplo de 4.
bytesTamaño decodificado en bytes.
errorSolo 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