§Как пользоваться
- Выберите вкладку: Base64, URL, HTML или Изображение.
- Введите текст в левое поле, код появится справа. Работает и в обратную сторону: вставьте Base64,
%D0%BF…или«…»в правое поле, и расшифровка появится слева. - Под правым полем выберите вариант: URL-safe Base64, режим URL-кодирования, какие символы превращать в мнемоники и в каком виде. Для текстов со старых русских сайтов слева есть кодировка Windows-1251.
- Во вкладке «Изображение» перетащите файл, выберите вид кода (data URI, чистый Base64, CSS или тег
<img>) и скопируйте его. Чтобы достать картинку из Base64, вставьте код в правое поле: появится предпросмотр и кнопка «Скачать файл».
Всё считается в браузере, текст и файлы никуда не отправляются. Если строка не декодируется, под полем написано, какой символ мешает и в какой позиции.
§Base64: как устроен и почему он длиннее
Base64 описан в RFC 4648. Каждые 3 байта он записывает 4 символами из алфавита A–Z a–z 0–9 + /, поэтому результат всегда примерно на треть длиннее исходных данных. Если байтов не кратно трём, в конце ставится один или два знака =. Почтовый стандарт MIME (RFC 2045) вдобавок требует разбивать Base64 на строки не длиннее 76 символов. Для этого есть переключатель «Строки по 76 символов».
Base64 переводит байты, а не буквы. Поэтому слово «Привет» сначала превращается в 12 байтов UTF-8 и только потом в 0J/RgNC40LLQtdGC. Встроенная функция btoa("Привет") в JavaScript выдаёт ошибку InvalidCharacterError, потому что принимает только латиницу. Здесь кириллица и эмодзи кодируются правильно. В кодировке Windows-1251 то же слово занимает 6 байтов и выглядит как z/Do4uXy.
URL-safe вариант (base64url) заменяет + на -, / на _ и убирает =, чтобы строку можно было вставить в адрес. Он используется в JWT и в ключах Web Push, подробнее в статье о Web Push без Firebase. Декодер здесь понимает оба алфавита, пробелы, переносы строк и отсутствующие =.
| Где встречается | Пример |
|---|---|
| Basic-авторизация в HTTP | Authorization: Basic dXNlcjpwYXNz (это user:pass) |
| Картинка внутри CSS или HTML | data:image/png;base64,iVBORw0KGgo… |
| Вложения в письмах | Content-Transfer-Encoding: base64 |
| JWT-токены | eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIn0.… |
Base64 не шифрует данные: любой раскодирует строку за секунду. Пароли и ключи в нём хранятся так же открыто, как в обычном тексте.
§URL-кодирование: какой режим выбрать
В адресе разрешены только латиница, цифры и несколько знаков. Всё остальное, в том числе кириллица и пробел, записывается байтами в виде %XX (RFC 3986). Буква кириллицы в UTF-8 занимает 2 байта, поэтому «привет» превращается в %D0%BF%D1%80%D0%B8%D0%B2%D0%B5%D1%82, то есть в 36 символов вместо 6. Главное различие режимов в том, какие служебные знаки адреса остаются как есть.
| Режим | Не кодирует | Пробел | Аналог | Когда нужен |
|---|---|---|---|---|
| Параметр | A–Z a–z 0–9 - _ . ! ~ * ' ( ) | %20 | encodeURIComponent() в JS | значение параметра или часть пути, где &, = и / должны стать кодами |
| Адрес | то же плюс ; , / ? : @ & = + $ # | %20 | encodeURI() в JS | адрес целиком, когда в нём кириллица, а структуру нужно сохранить |
| Форма | A–Z a–z 0–9 - _ . * | + | URLSearchParams в JS, urlencode() в PHP | тело POST-формы и строка запроса, собранная из формы (спецификация) |
Если адрес раскодировался в набор странных символов или с ошибкой UTF-8, скорее всего его собрал старый сайт в Windows-1251: там «привет» выглядит как %EF%F0%E8%E2%E5%F2. Переключите кодировку слева. Для новых адресов кириллицу лучше заменить транслитом, это делает генератор ЧПУ.
Одиночный знак % без двух шестнадцатеричных цифр после него ломает декодирование. В JavaScript это ошибка URIError: URI malformed, а здесь вы увидите позицию проблемного знака. Сам процент кодируется как %25.
§HTML-мнемоники и числовые коды
Пять символов в HTML служебные, и в тексте их нужно заменять ссылками на символы (спецификация HTML). У каждого символа есть числовой код в десятичном (&) или шестнадцатеричном (&) виде, а у части символов есть ещё и имя (&).
| Символ | Мнемоника | Десятичный код | Шестнадцатеричный | Когда обязателен |
|---|---|---|---|---|
& | & | & | & | в тексте и в атрибутах, в том числе в ссылках: ?a=1&b=2 |
< | < | < | < | в тексте, чтобы браузер не принял его за начало тега |
> | > | > | > | строго не обязателен, но принято заменять парой к < |
" | " | " | " | в атрибутах в двойных кавычках |
' | ' | ' | ' | в атрибутах в одинарных кавычках. ' нет в HTML 4, поэтому кодировщик пишет ' |
Если страница в UTF-8, кириллицу и типографские знаки кодировать не нужно. Режим «+ не ASCII» пригодится для писем, старых CMS и систем, которые принимают только латиницу. Тогда «ёлочки» станут « и », тире станет —, знак номера №. У знака тенге ₸ имени нет, только код ₸. Режим «Всё» превращает в коды каждый символ: так иногда прячут e-mail от простых сборщиков адресов.
Коды от € до Ÿ браузер по историческим причинам читает как символы Windows-1252: – показывает короткое тире, а не управляющий символ. Декодер повторяет это поведение. Мнемоники он понимает все, которые знает браузер, а не только популярные.
§Картинка в Base64: когда это выгодно
Картинка в виде текста записывается как data URI (RFC 2397): data:<тип>;base64,<данные>. Такую строку можно вставить в src или в CSS-свойство background-image, и браузер не будет делать за картинкой отдельный запрос. Цена такая:
- Base64 на треть тяжелее файла, а PNG, JPEG и WebP уже сжаты, поэтому gzip почти ничего не возвращает;
- картинка кешируется вместе с CSS или HTML и скачивается заново при каждом их изменении;
- большой data URI в CSS задерживает отрисовку страницы, пока стили не загрузятся целиком;
- Gmail и многие другие почтовые клиенты не показывают картинки в data URI, поэтому для подписи в письме этот способ не подходит.
Встраивать имеет смысл маленькие иконки и фоны до нескольких килобайт. SVG выгоднее вставлять без Base64, с URL-кодированием: строка короче и читается. Для этого есть инструмент SVG в CSS, а почему так лучше, разобрано в статье про SVG в вёрстке.
Если в правое поле вставить Base64 без заголовка data:, тип файла определяется по первым байтам. Их же можно узнать по началу строки:
| Начало Base64 | Формат |
|---|---|
iVBORw0KGgo | PNG |
/9j/ | JPEG |
R0lGOD | GIF |
UklGR | WebP (и другие файлы RIFF) |
PHN2Zy или PD94bWwg | SVG (<svg или <?xml) |
JVBERi0 |
