Base64 File Encoder

Що таке кодування файлів у Base64?

Кодування файлів у Base64 перетворює бінарні файли — PDF, ZIP, зображення, виконувані файли, шрифти, аудіо — на звичайний ASCII-текст за алфавітом, визначеним у RFC 4648. Кожні три байти бінарного вхідного потоку перетворюються на чотири символи Base64, формуючи текстове представлення, яке можна передавати через канали, призначені виключно для тексту: JSON API-запити, XML-документи, тіла листів, HTML-атрибути та змінні середовища.

На відміну від кодування тексту у Base64 (що працює з рядками), кодування файлу у Base64 зчитує сирий байтовий потік будь-якого файлу незалежно від його формату. Бінарні заголовки PDF, стиснені блоки ZIP та піксельні дані PNG обробляються однаково: як послідовність октетів для перекодування. Результат завжди є коректним ASCII, безпечним для вставки скрізь, де допускаються символи, що друкуються.

Компроміс — розмір: вихідні дані Base64 приблизно на 33% більші за оригінальний бінарний файл. Для PDF розміром 1 МБ це означає приблизно 1,33 МБ тексту Base64. Цей оверхед є наслідком представлення 8-бітних байтів 6-бітними символами і властивий самому кодуванню — жодна реалізація не може його уникнути. Попри це, кодування файлів у Base64 лишається стандартним методом вбудовування бінарних даних у текстові формати, визначеним у MIME (RFC 2045), data URI (RFC 2397) та JSON Web Tokens (RFC 7519).

Чому варто використовувати цей Base64 File Encoder?

Цей інструмент кодує файли у Base64 безпосередньо у вашому браузері за допомогою FileReader API. Жоден файл не завантажується на сервер — все перетворення відбувається на стороні клієнта в JavaScript.

Сценарії використання кодування файлів у Base64

Оверхед розміру файлу при кодуванні у Base64

Кодування у Base64 збільшує розмір даних рівно на одну третину. Кожні 3 вхідні байти дають 4 вихідні символи (кожен представляє 6 біт). Символи доповнення (=) додаються, коли довжина вхідних даних не кратна 3. Таблиця нижче показує співвідношення між розміром оригінального файлу та розміром закодованого виходу.

Data URI та довідник MIME-типів

Data URI вбудовує вміст файлу безпосередньо в HTML, CSS або JavaScript у форматі data:[MIME type];base64,[encoded data]. MIME-тип вказує браузеру, як інтерпретувати декодовані байти. Нижче наведено поширені розширення файлів, їхні MIME-типи та відповідний префікс data URI.

Приклади коду

Ці готові до запуску приклади демонструють, як зчитати бінарний файл і закодувати його у Base64 на JavaScript, Python, Node.js, bash та Go. Кожен фрагмент генерує стандартний Base64 (RFC 4648, секція 4) з доповненням.

// Read a file from an <input> element and encode to Base64
const input = document.querySelector('input[type="file"]')
input.addEventListener('change', (e) => {
  const file = e.target.files[0]
  const reader = new FileReader()
  reader.onload = () => {
    const base64 = reader.result.split(',')[1]
    console.log(base64) // → "JVBERi0xLjQK..." (raw Base64, no data URI prefix)
  }
  reader.readAsDataURL(file)
})

// Convert a Blob to Base64 with async/await
async function blobToBase64(blob) {
  const buffer = await blob.arrayBuffer()
  const bytes = new Uint8Array(buffer)
  let binary = ''
  bytes.forEach(b => binary += String.fromCharCode(b))
  return btoa(binary) // → standard Base64 string
}

import base64
from pathlib import Path

# Encode a file to Base64
file_bytes = Path('document.pdf').read_bytes()
encoded = base64.b64encode(file_bytes).decode('ascii')
print(encoded[:40])  # → "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PA..."

# Write encoded output to a text file
Path('document.b64.txt').write_text(encoded)

# Build a data URI from a file
mime_type = 'application/pdf'
data_uri = f'data:{mime_type};base64,{encoded}'
print(data_uri[:60])  # → "data:application/pdf;base64,JVBERi0xLj..."

import { readFileSync, writeFileSync } from 'fs'

// Encode a file to Base64
const buffer = readFileSync('archive.zip')
const base64 = buffer.toString('base64')
console.log(base64.length) // → 1398104 (for a ~1 MB file)

// Save Base64 output to a file
writeFileSync('archive.b64.txt', base64)

// Build a data URI
const mime = 'application/zip'
const dataUri = `data:${mime};base64,${base64}`

# Encode a file to Base64 (macOS / Linux)
base64 < document.pdf > document.b64.txt

# Encode with no line wrapping (GNU coreutils)
base64 -w 0 < document.pdf > document.b64.txt

# Encode and copy to clipboard (macOS)
base64 < image.png | pbcopy

# Encode with OpenSSL (available everywhere)
openssl base64 -in archive.zip -out archive.b64.txt

# Pipe directly into curl for API upload
base64 -w 0 < photo.jpg | curl -X POST -d @- https://api.example.com/upload

package main

import (
	"encoding/base64"
	"fmt"
	"os"
)

func main() {
	data, err := os.ReadFile("document.pdf")
	if err != nil {
		panic(err)
	}
	encoded := base64.StdEncoding.EncodeToString(data)
	fmt.Println(len(encoded)) // → 1398104 (for a ~1 MB file)

	// Write to file
	os.WriteFile("document.b64.txt", []byte(encoded), 0644)
}

Часті запитання