Varför Base64 inte fungerar med all text
Om btoa() klarar Hello men misslyckas med koreansk text eller emoji saknas oftast ett steg för teckenkodning. Base64 representerar byte. En JavaScript-sträng behöver först en överenskommen omvandling till byte, och mottagaren måste göra den omvända omvandlingen.
En offentlig felrapport gällde SVG-kod med icke-latinska tecken. En annan beskrev avkodning av innehåll från GitHub API där ett varumärkestecken blev förvanskat. I det första fallet uppstår felet vid kodning, i det andra vid avkodning. Ett lyckat atob()-anrop ger en binär sträng, inte automatiskt läsbar UTF-8-text.
Koda texten som UTF-8 och kontrollera att den går att återställa
Om du ansvarar för koden som skapar Base64 ska du rätta övergången från text till byte, inte ta bort tecknen som utlöser felet. Dessa hjälpfunktioner för JavaScript i webbläsaren gör övergången uttrycklig. De är avsedda för förhållandevis små textmängder, inte stora uppladdningar.
function encodeUtf8Base64(text) {
const bytes = new TextEncoder().encode(text);
let binary = "";
for (const byte of bytes) binary += String.fromCharCode(byte);
return btoa(binary);
}
function decodeUtf8Base64(encoded) {
const binary = atob(encoded);
const bytes = Uint8Array.from(binary, c => c.charCodeAt(0));
return new TextDecoder("utf-8", {
fatal: true, ignoreBOM: true
}).decode(bytes);
}
const original = "Hello, 한글 ™ 🌍";
const encoded = encodeUtf8Base64(original);
const restored = decodeUtf8Base64(encoded);
console.log(encoded); // SGVsbG8sIO2VnOq4gCDihKIg8J+MjQ==
console.log(restored === original); // trueLägg hjälpfunktionerna bredvid din befintliga konverteringskod och testa exemplet innan du använder riktigt innehåll. Likhetskontrollen ska ge true. Om den ger false jämför du strängarna före kodning och efter avkodning. Bedöm inte resultatet enbart utifrån om det ”ser ut som Base64”. Ta med en bokstav med accent, en emoji och en tom sträng i testerna.
Om du bara tar emot data behöver du fråga vilka byte avsändaren kodade. Base64-alfabetet talar inte om att innehållet är UTF-8. Om Base64-avkodningen lyckas men UTF-8-avkodningen misslyckas kan innehållet ha en annan teckenkodning eller vara en annan typ av fil än text. Bevara byte från en PNG eller PDF som binära data i stället för att köra dem genom en textavkodare.
I ett användarverktyg ska felaktig indata fångas upp och originalet finnas kvar för redigering. Ersätt inte en misslyckad avkodning med ett tomt resultat som ser lyckat ut. Klistra aldrig in privata token i en okänd nätkonverterare: Base64 gör innehåll portabelt, inte hemligt.
Varför tester med enbart ASCII missar problemet
Två val för avkodaren är värda att uppmärksamma: fatal: true avvisar ogiltig UTF-8 i stället för att tyst sätta in ersättningstecken; ignoreBOM: true bevarar en inledande textmarkör. TextEncoder ersätter ett ensamt UTF-16-surrogat, så omvandlingen är inte förlustfri för varje tänkbar JavaScript-sträng.
Ett sparat lokalt webbläsartest använde Hello, 한글 ™ 🌍. Ett direkt btoa()-anrop kastade InvalidCharacterError. TextEncoder skapade 22 UTF-8-byte, vilka kodades till SGVsbG8sIO2VnOq4gCDihKIg8J+MjQ==. När dessa byte avkodades som UTF-8 återställdes exakt samma mening. Detta är ett syntetiskt lokalt test, inte någon av rapportörernas applikationer.
Tester med enbart ASCII kan dölja ett fel. I exemplet gav btoa("é") resultatet 6Q==, medan UTF-8-kodning först gav w6k=. Det första anropet kastade inget fel, men dess byte är fel för en mottagare som förväntar sig UTF-8. Base64 innehåller ingen deklaration av teckenkodningen.
Avkoda och kontrollera hela tur-och-retur-omvandlingen
Base64 är varken kryptering eller URL-kodning. Ett plustecken kan tolkas särskilt i frågeparametrar; följ den länkade guiden om sådana parametrar. Undvik den föråldrade lösningen med unescape, sätt rimliga gränser för datamängden och exponera aldrig privat innehåll bara för att visa ett kodningsfel.

Källor, exempel och vidare läsning
- Offentlig diskussion: Base64-kodning misslyckas med icke-latinska tecken
- Offentlig diskussion: JavaScripts atob avkodar inte UTF-8-strängar korrekt
- MDN-referens: btoa
- Ursprungligt kompletterande diagram
- Sparat lokalt testunderlag
- MDN-referens: TextEncoder
- MDN-referens: atob
- MDN-referens: TextDecoder
- MDN-referens: ignoreBOM
- MDN-referens: decode
- MDN-referens: unescape
- Relaterad guide: Base64 i frågeparametrar
- Varför JSON som ser giltig ut misslyckas vid första tecknet
- Varför text som ser likadan ut inte matchar