Subir un archivo
  1. base64hub
  2. Descargas
  3. Paquete npm
v1.0.0 · Código abierto · MIT

base64hub en npm: biblioteca y CLI de Base64 para Node.js

npm i base64hub le da a Node.js una pequeña biblioteca Base64 con errores estrictos y salida URL-safe, y la misma herramienta de línea de comandos b64 que las versiones nativas.

npm i base64hub
Gratis sin cuenta, sin clave MIT licencia de código abierto Cero dependencias en tiempo de ejecución Actualizado 22 nov 2026

Qué incluye el paquete

base64hub es un módulo ES con cuatro funciones y sin dependencias. Funciona en Node.js 18 y posteriores.

FunciónDevuelve
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)
Bufferbtoa / atobbase64hub
Texto Unicodesísolo Latin-1sí, como UTF-8
Alfabeto URL-safecodificación "base64url"no{ url: true }, y se acepta al decodificar
Caracteres no válidosse omiten sin avisoerrorerror con posición
Validaciónnonovalidate()
URI data:nonodataUri(), 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.

Más de base64hub