- base64hub
- Документация
- Пакет 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 или любым представлением типизированного массива.
| Параметр | Тип | По умолчанию | Действие |
|---|---|---|---|
url | boolean | false | URL-safe алфавит (- и _). |
pad | boolean | true | Добавлять дополнение =. |
wrap | number | 0 | Вставлять \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" }
| Поле | Значение |
|---|---|
valid | true или false. |
variant | standard (встретился + или /), 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 г.