Загрузить файл
  1. base64hub
  2. Документация
  3. Пакет npm

Справочник по пакету npm

base64hub – ES-модуль для Node.js 18 и новее: четыре функции, типы TypeScript и команда b64. Без зависимостей.

Установка

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

Пакет распространяется только как ESM. Подключайте его через import, а из CommonJS используйте await import("base64hub"). Определения типов идут в комплекте.

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

encode(input, options?)

Кодирует байты или байты UTF-8 строки и возвращает строку. input может быть строкой, Uint8Array (Buffer из Node.js – тоже Uint8Array), ArrayBuffer или любым представлением типизированного массива.

ПараметрТипПо умолчаниюДействие
urlbooleanfalseURL-safe алфавит (- и _).
padbooleantrueДобавлять дополнение =.
wrapnumber0Вставлять \n после каждых N символов, но не в конце; 76 – 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)

Декодирует Base64 в Uint8Array. Принимает пробелы, табуляции и переводы строк, префикс data:...;base64,, строки без дополнения и оба алфавита. На всём остальном выбрасывается Base64Error, у которого position – индекс неверного символа в очищенных данных, считая от 0.

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
}

Для текста используйте new TextDecoder().decode(bytes), а Buffer.from(bytes) – когда другому API Node.js нужен Buffer.

validate(text)

Проверяет текст, не выбрасывая исключений. Результат корректен ровно тогда, когда decode выполнился бы успешно.

validate("SGVsbG8sIGh1YiE");
// { valid: true, variant: 'either', padded: false, bytes: 11 }
validate("Zm9v!");
// { valid: false, error: "invalid character '!' at position 4" }
ПолеЗначение
validtrue или false.
variantstandard (встретился + или /), url (встретился - или _), mixed (и те и другие) или either (ни тех ни других).
paddedДлина очищенных данных вместе с = кратна 4.
bytesРазмер после декодирования в байтах.
errorТолько для некорректных данных: причина, тот же текст, который выбросил бы decode.

dataUri(input, mime?)

Собирает строку data:<mime>;base64,<payload>: стандартный алфавит, с дополнением, без переносов. Без mime тип определяется автоматически: PNG, JPEG, GIF, WebP, PDF и SVG по сигнатуре, text/plain;charset=utf-8 для текста UTF-8, а иначе 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..."

Команда b64

npm i -g base64hub устанавливает b64, а npx base64hub "Hello, hub!" запускает её один раз без установки. Флаги, сообщения и коды выхода совпадают со справочником по CLI. Сборка из npm перед обработкой читает весь вход в память; для очень больших файлов используйте сборку на Go.

Обновлено 22 нояб. 2026 г.