Base64 dukker op overalt når du begynder at se — JWT-tokens, data-URI'er, e-mail-vedhæftninger,
API-payloads med binære filer. Selve kodningen er defineret i
RFC 4648
og er dødenkelt i konceptet: tag arbitrære bytes og repræsenter dem ved brug af kun 64 udskrivbare
ASCII-tegn. Det der snubler folk er implementationen i JavaScript — forskellige API'er i
browser vs Node.js, Unicode-fælden der får btoa() til at kaste undtagelser, og
URL-sikker variant som JWT'er er afhængige af. Denne guide dækker alt med fungerende kode.
btoa() og atob() i browseren
Browseren har haft
btoa()
og
atob()
i lang tid. Navnene er forvirrende (binary to ASCII og tilbage), men brugen er
ligetil for simple strenge:
// Encode a plain ASCII string
const encoded = btoa('hello world');
console.log(encoded); // "aGVsbG8gd29ybGQ="
// Decode it back
const decoded = atob('aGVsbG8gd29ybGQ=');
console.log(decoded); // "hello world"
// A more realistic example — encoding a simple auth token
const credentials = 'apiuser:s3cr3tkey';
const basicAuth = 'Basic ' + btoa(credentials);
// "Basic YXBpdXNlcjpzM2NyM3RrZXk="
// This is exactly what HTTP Basic Authentication usesbtoa() håndterer kun strenge hvor
hvert tegn har et kodepunkt ≤ 255 (Latin-1-området). Send en streng med
et emoji eller et ikke-latinsk tegn og den kaster InvalidCharacterError øjeblikkeligt.
Dette er en af de mest almindelige Base64-fejl i browserkode.// ❌ This throws — emoji is outside Latin-1
btoa('Hello 🌍');
// Uncaught DOMException: Failed to execute 'btoa' on 'Window':
// The string to be encoded contains characters outside of the Latin1 range.
// ❌ This also throws — any non-ASCII character will do it
btoa('café');
// Uncaught DOMException: ...Håndtering af Unicode sikkert i browseren
Løsningen er først at kode strengen til UTF-8-bytes og derefter Base64-kode disse bytes.
Den klassiske tilgang bruger encodeURIComponent og et procent-dekodningstrick. Den moderne
tilgang bruger TextEncoder, som er
tilgængelig i alle moderne browsere
og Node.js 11+:
// ✅ Unicode-safe encode using TextEncoder
function encodeBase64(str) {
const bytes = new TextEncoder().encode(str); // UTF-8 byte array
const binString = Array.from(bytes, byte =>
String.fromCodePoint(byte)
).join('');
return btoa(binString);
}
// ✅ Unicode-safe decode using TextDecoder
function decodeBase64(base64Str) {
const binString = atob(base64Str);
const bytes = Uint8Array.from(binString, char =>
char.codePointAt(0)
);
return new TextDecoder().decode(bytes);
}
// Now emojis and international text work fine
console.log(encodeBase64('Hello 🌍')); // "SGVsbG8g8J+MjQ=="
console.log(decodeBase64('SGVsbG8g8J+MjQ==')); // "Hello 🌍"
console.log(encodeBase64('Héllo café')); // "SMOpbGxvIGNhZsOp"
console.log(decodeBase64('SMOpbGxvIGNhZsOp')); // "Héllo café"Gem disse to hjælpefunktioner et sted i din kodebase og glem at den bare
btoa() eksisterer. Parret TextEncoder/TextDecoder er
det rigtige værktøj til alt ud over ren ASCII. Du kan prøve det nu med
Base64 Encoder-værktøjet.
Buffer.from() i Node.js
Node.js har sit eget API til dette via Buffer-klassen, som håndterer kodning/dekodning renere. Der er ingen Unicode-faldgrube her fordi du eksplicit angiver inputkodningen:
// Encode string → Base64
const encoded = Buffer.from('Hello 🌍', 'utf8').toString('base64');
console.log(encoded); // "SGVsbG8g8J+MjQ=="
// Decode Base64 → string
const decoded = Buffer.from('SGVsbG8g8J+MjQ==', 'base64').toString('utf8');
console.log(decoded); // "Hello 🌍"
// Practical example — encoding a JSON payload to embed in a config file
const config = {
apiKey: 'sk-prod-abc123',
projectId: 'proj_x9f2k',
region: 'us-east-1'
};
const encodedConfig = Buffer.from(JSON.stringify(config), 'utf8').toString('base64');
// eyJhcGlLZXkiOiJzay1wcm9kLWFiYzEyMyIsInByb2plY3RJZCI6InByb2pfeDlmMmsiLCJyZWdpb24iOiJ1cy1lYXN0LTEifQ==
// Decode and parse it back
const decodedConfig = JSON.parse(
Buffer.from(encodedConfig, 'base64').toString('utf8')
);
console.log(decodedConfig.region); // "us-east-1"Bemærk at btoa() og atob() også er tilgængelige i Node.js 16+
som globale variabler (for browserkompatibilitet), men Buffer-API'et er mere idiomatisk i
Node.js og har været der siden
Node.js v0.1.
Til JSON-specifik kodning er JSON to Base64-værktøjet praktisk
til hurtige manuelle konverteringer.
URL-sikker Base64 — hvad JWT'er faktisk bruger
Standard Base64 bruger + og / i sit alfabet. Begge disse
tegn er specielle i URL'er — + betyder et mellemrum i forespørgselsstrenge, og /
er en stiseparator. Når du har brug for Base64 i en URL eller som et JWT-segment, bruger du URL-sikker
variant: erstat + med - og / med _,
fjern derefter =-udfyldningen. Dette standardiseres i
RFC 4648 §5
og er hvad hvert JWT-bibliotek bruger internt:
// Convert standard Base64 to URL-safe Base64
function toBase64Url(base64Str) {
return base64Str
.replace(/+/g, '-')
.replace(///g, '_')
.replace(/=+$/, ''); // strip padding
}
// Convert URL-safe Base64 back to standard Base64
function fromBase64Url(base64UrlStr) {
// Restore padding — length must be a multiple of 4
const padded = base64UrlStr + '==='.slice((base64UrlStr.length + 3) % 4);
return padded
.replace(/-/g, '+')
.replace(/_/g, '/');
}
// Encode a string to URL-safe Base64
function encodeBase64Url(str) {
return toBase64Url(btoa(str));
}
// Decode URL-safe Base64 to a string
function decodeBase64Url(str) {
return atob(fromBase64Url(str));
}
// Example: manually inspect a JWT payload
const jwt = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOjQyLCJyb2xlIjoiYWRtaW4iLCJpYXQiOjE3MTM0MDAwMDB9.signature';
const [header, payload] = jwt.split('.');
console.log(decodeBase64Url(header));
// {"alg":"HS256","typ":"JWT"}
console.log(decodeBase64Url(payload));
// {"userId":42,"role":"admin","iat":1713400000}Det er derfor du ser Base64-strenge som
eyJhbGciOiJIUzI1NiJ9 i JWT'er — ingen udfyldning, bindestreger i stedet for plusser.
Når du sender kodet data som en URL-forespørgselsparameter, brug altid URL-sikker variant for at
undgå ødelagte URL'er. Base64 Decoder-værktøjet håndterer både
standard og URL-sikker Base64 automatisk.
Kodning af en fil med FileReader API
En almindelig browseropgave: brugeren vælger et billede eller dokument, og du skal sende det
til et API som Base64.
FileReader API
har readAsDataURL() til præcis dette — det giver dig en komplet data-URI med
MIME-typen inkluderet:
// Wrap FileReader in a Promise for easier async usage
function fileToBase64(file) {
return new Promise((resolve, reject) => {
const reader = new FileReader();
reader.onload = () => {
// result is "data:image/png;base64,iVBORw0KGgo..."
// Strip the data URI prefix to get just the Base64 string
const base64 = reader.result.split(',')[1];
resolve(base64);
};
reader.onerror = () => reject(new Error('Failed to read file'));
reader.readAsDataURL(file);
});
}
// Hook it up to a file input
const fileInput = document.getElementById('avatarUpload');
fileInput.addEventListener('change', async (event) => {
const file = event.target.files[0];
if (!file) return;
try {
const base64 = await fileToBase64(file);
console.log(`File size: ${file.size} bytes`);
console.log(`Base64 length: ${base64.length} chars`);
// Send to your API
await fetch('/api/users/42/avatar', {
method: 'PUT',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ image: base64, mimeType: file.type })
});
} catch (err) {
console.error('Upload failed:', err.message);
}
});Hvis du har brug for den fulde data-URI (inklusive MIME-type-præfikset) frem for blot
rå Base64, spring .split(',')[1] over og brug reader.result direkte.
Til massekonvertering af filer håndterer Image to Base64-værktøjet
billeder uden at skrive nogen kode.
Kodning af binær data og Uint8Arrays
Nogle gange starter du ikke fra en streng eller en fil — du har rå bytes fra en
WebCrypto-operation, en canvas-eksport eller et WebAssembly-modul. Her er hvordan man går fra en
Uint8Array til Base64 og tilbage i begge miljøer:
// --- Browser ---
// Uint8Array → Base64 (browser)
function uint8ToBase64(bytes) {
const binString = Array.from(bytes, byte =>
String.fromCodePoint(byte)
).join('');
return btoa(binString);
}
// Base64 → Uint8Array (browser)
function base64ToUint8(base64Str) {
const binString = atob(base64Str);
return Uint8Array.from(binString, char => char.codePointAt(0));
}
// Example: export a canvas as raw PNG bytes → Base64
const canvas = document.getElementById('myCanvas');
canvas.toBlob(blob => {
blob.arrayBuffer().then(buffer => {
const bytes = new Uint8Array(buffer);
const encoded = uint8ToBase64(bytes);
console.log('PNG as Base64:', encoded.slice(0, 40) + '...');
});
}, 'image/png');
// --- Node.js ---
// Uint8Array / Buffer → Base64 (Node.js)
function uint8ToBase64Node(bytes) {
return Buffer.from(bytes).toString('base64');
}
// Base64 → Buffer (Node.js)
function base64ToBufferNode(base64Str) {
return Buffer.from(base64Str, 'base64');
}
// Example: hash a password and encode the result
const crypto = require('crypto');
const hash = crypto.createHash('sha256').update('mySecretPassword').digest();
// hash is a Buffer (which extends Uint8Array)
console.log(hash.toString('base64'));
// "XohImNooBHFR0OVvjcYpJ3NgxxxxxxxxxxxxxA=="Indlejring af billeder som data-URI'er
En af de mest praktiske anvendelser af Base64 i webudvikling er indlejring af billeder direkte i HTML eller CSS, hvilket eliminerer en HTTP-anmodning. Du har sandsynligvis set data-URI'er i inline SVG'er eller e-mailskabeloner. Her er mønstret:
<!-- Inline image in HTML — no separate network request -->
<img
src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
alt="1x1 transparent pixel"
width="1"
height="1"
/>/* Inline background image in CSS — commonly used for small icons and loading spinners */
.spinner {
width: 32px;
height: 32px;
background-image: url("data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZD0iTTEyIDJhMTAgMTAgMCAxIDAgMCAyMCAxMCAxMCAwIDAgMCAwLTIweiIvPjwvc3ZnPg==");
background-repeat: no-repeat;
background-position: center;
background-size: contain;
}// Generate a data URI from a fetched image (Node.js)
const fs = require('fs');
const path = require('path');
function imageFileToDataUri(filePath) {
const ext = path.extname(filePath).slice(1).toLowerCase();
const mimeMap = { png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg',
gif: 'image/gif', svg: 'image/svg+xml', webp: 'image/webp' };
const mimeType = mimeMap[ext] ?? 'application/octet-stream';
const fileData = fs.readFileSync(filePath);
const base64 = fileData.toString('base64');
return `data:${mimeType};base64,${base64}`;
}
const dataUri = imageFileToDataUri('./logo.png');
// "data:image/png;base64,iVBORw0KGgo..."
// Drop this into an <img src> or CSS background-imageEt kompakt hjælpemodul til begge miljøer
Frem for at sprede btoa()-kald rundt i din kodebase er det værd at have
et enkelt hjælpemodul der dækker Unicode, URL-sikre varianter og fungerer i både
browser og Node.js. Her er et der gør alt det:
// base64.js — drop into any project
const isNode = typeof process !== 'undefined' && process.versions?.node;
export function encode(str) {
if (isNode) {
return Buffer.from(str, 'utf8').toString('base64');
}
// Browser: encode to UTF-8 bytes first, then Base64
const bytes = new TextEncoder().encode(str);
const binString = Array.from(bytes, b => String.fromCodePoint(b)).join('');
return btoa(binString);
}
export function decode(base64Str) {
if (isNode) {
return Buffer.from(base64Str, 'base64').toString('utf8');
}
// Browser: Base64 → bytes → UTF-8 string
const binString = atob(base64Str);
const bytes = Uint8Array.from(binString, c => c.codePointAt(0));
return new TextDecoder().decode(bytes);
}
export function encodeUrlSafe(str) {
return encode(str)
.replace(/+/g, '-')
.replace(///g, '_')
.replace(/=+$/, '');
}
export function decodeUrlSafe(str) {
const padded = str + '==='.slice((str.length + 3) % 4);
return decode(padded.replace(/-/g, '+').replace(/_/g, '/'));
}
export function encodeBytes(bytes) {
if (isNode) return Buffer.from(bytes).toString('base64');
const binString = Array.from(bytes, b => String.fromCodePoint(b)).join('');
return btoa(binString);
}
export function decodeToBytes(base64Str) {
if (isNode) return Buffer.from(base64Str, 'base64');
const binString = atob(base64Str);
return Uint8Array.from(binString, c => c.codePointAt(0));
}// Usage examples
import { encode, decode, encodeUrlSafe, decodeUrlSafe } from './base64.js';
encode('Hello 🌍'); // "SGVsbG8g8J+MjQ=="
decode('SGVsbG8g8J+MjQ=='); // "Hello 🌍"
encodeUrlSafe('[email protected]'); // "dXNlckBleGFtcGxlLmNvbQ" (no +, /, or =)
decodeUrlSafe('dXNlckBleGFtcGxlLmNvbQ'); // "[email protected]"Almindelige faldgruber at holde øje med
- btoa() kaster undtagelser for ikke-latinske tegn — ethvert tegn over kodepunkt 255 forårsager
InvalidCharacterError. Brug altidTextEncoder-tilgangen ellerBuffer.from(str, 'utf8')i Node.js. - Udfyldning betyder noget for dekodning — Base64-strenge skal have en længde der er et multiplum af 4. Manglende
=-udfyldning fåratob()til stille at returnere skrald eller kaste en undtagelse afhængigt af browseren. Gendan altid udfyldning inden dekodning af URL-sikre strenge. - Buffer vs strengkodning i Node.js —
Buffer.from(str)er som standard UTF-8, menBuffer.from(str, 'binary')behandler strengen som Latin-1-bytes. Brug af forkert kodning ved dekodning giver forvrænget output der kan være svært at debugge. - Data-URI MIME-type —
data:;base64,...(ingen MIME-type) vil fungere i nogle browsere men ikke andre. Inkluder altid MIME-typen:data:image/png;base64,.... - Linjeskift i MIME Base64 — RFC 4648 tillader implementationer at indsætte linjeskift hvert 76. tegn (som e-mailkodere gør).
atob()ogBuffer.from()håndterer begge dette, men hvis du selv genererer Base64, tilføj ikke linjeskift medmindre målsystemet forventer dem.
Opsummering
Base64 i JavaScript er et af de emner der ser trivielle ud indtil det bider dig.
Den korte version: brug aldrig bare btoa() til noget brugergenereret — wrap det
med TextEncoder for at håndtere Unicode korrekt. I Node.js er Buffer.from(str,
'utf8').toString('base64') det rigtige idiom. Når den kodede streng ender i en
URL eller JWT, skift til URL-sikker variant. Til hurtige eksperimenter eller engangskoverteringer sparer værktøjerne
Base64 Encoder, Base64 Decoder,
og JSON to Base64 tid. Siden
MDN Base64-ordbogen
har også en solid browserorienteret reference hvis du har brug for en anden mening.