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:

js
// 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 uses
Unicode-fælden: btoa() 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.
js
// ❌ 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+:

js
// ✅ 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:

js
// 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:

js
// 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:

js
// 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:

js
// --- 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:

html
<!-- Inline image in HTML — no separate network request -->
<img
  src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
  alt="1x1 transparent pixel"
  width="1"
  height="1"
/>
css
/* 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;
}
js
// 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-image
Størrelseadvarsel: Base64-kodning oppuster filstørrelse med ca. 33%. Et 100 KB billede bliver ~133 KB Base64-tekst. Data-URI'er er bedst til små aktiver (ikoner, SVG'er, winzige sprites) — ikke til fotos eller store billeder. Til dem gør HTTP/2-multipleksning separate anmodninger hurtigere end indlejring.

Et 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:

js
// 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));
}
js
// 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 altid TextEncoder-tilgangen eller Buffer.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år atob() 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.jsBuffer.from(str) er som standard UTF-8, men Buffer.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-typedata:;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() og Buffer.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.