InvalidCharacterError: Failed to execute 'btoa' on 'Window': The string to be encoded contains characters outside of the Latin1 range.
btoa acceptă doar caractere Latin1 (coduri 0–255), iar textul tău conține diacritice ca ș, ț, ă sau emoji. Transformă întâi textul în octeți UTF-8 cu TextEncoder, apoi codifică octeții în Base64. La decodare, faci invers cu atob și TextDecoder.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
btoa („binary to ASCII”) codifică în Base64 un text în care fiecare caracter reprezintă un octet, deci are cod între 0 și 255 (setul Latin1). Literele românești ș, ț, ă (ă = 259, ș = 537, ț = 539) și emoji au coduri mai mari, așa că btoa refuză textul: în Chrome mesajul e The string to be encoded contains characters outside of the Latin1 range, în Node e DOMException [InvalidCharacterError]: Invalid character.
Curios e că â și î merg (au coduri sub 256), iar ș și ț nu, de aceea eroarea apare doar la unele texte: un nume ca „Ion” trece, „Ștefan” pică.
Reparația corectă: transformi textul în octeți UTF-8 cu new TextEncoder().encode(text), faci din octeți un text binar (un caracter per octet) și abia pe acesta îl dai lui btoa. La citire, atob dă textul binar, din care refaci octeții și îi decodezi cu TextDecoder. Nu folosi unescape(encodeURIComponent(...)): funcționează, dar unescape e învechit.
De ce apare: cauzele frecvente
1Text cu diacritice dat direct lui btoa
const cod = btoa("Ștefan");const octeti = new TextEncoder().encode("Ștefan");
const cod = btoa(String.fromCharCode(...octeti));Fiecare octet UTF-8 are valoare 0–255, deci textul binar format din ei e acceptat de btoa.
2Obiect JSON cu diacritice salvat în Base64
const token = btoa(JSON.stringify({ oras: "Brașov" }));const json = JSON.stringify({ oras: "Brașov" });
const token = btoa(String.fromCharCode(...new TextEncoder().encode(json)));JSON-ul păstrează diacriticele, deci trebuie trecut prin TextEncoder înainte de btoa.
3Decodare fără TextDecoder
const text = atob(cod); // dă „Ètefan”const binar = atob(cod);
const octeti = Uint8Array.from(binar, (c) => c.charCodeAt(0));
const text = new TextDecoder().decode(octeti);Fără TextDecoder, fiecare octet devine un caracter separat și diacriticele apar stricate.
Repară eroarea, direct în pagină
Funcția inBase64 codifică un mesaj pentru un link, dar textul are diacritice și btoa aruncă InvalidCharacterError (în Node: Invalid character). Repară funcția astfel încât textul să fie transformat întâi în octeți UTF-8 cu TextEncoder, iar programul să afișeze codul Base64 și textul decodat înapoi.
function inBase64(text) {
return btoa(text);
}
function dinBase64(cod) {
const binar = atob(cod);
const octeti = Uint8Array.from(binar, (c) => c.charCodeAt(0));
return new TextDecoder().decode(octeti);
}
const cod = inBase64("mere și pere");
console.log(cod);
console.log(dinBase64(cod));bWVyZSDImWkgcGVyZQ== mere și pere
Indiciu
Fă din octeții UTF-8 un text binar cu String.fromCharCode, apoi dă-l lui btoa.
Reparația
function inBase64(text) {
const octeti = new TextEncoder().encode(text);
let binar = "";
for (const octet of octeti) {
binar += String.fromCharCode(octet);
}
return btoa(binar);
}
function dinBase64(cod) {
const binar = atob(cod);
const octeti = Uint8Array.from(binar, (c) => c.charCodeAt(0));
return new TextDecoder().decode(octeti);
}
const cod = inBase64("mere și pere");
console.log(cod);
console.log(dinBase64(cod));De ce merge
btoa acceptă doar caractere cu cod 0–255, iar ș are codul 537. TextEncoder transformă textul în octeți UTF-8, unde ș devine doi octeți, ambii sub 256. Din fiecare octet facem un caracter, iar textul binar rezultat trece de btoa. dinBase64 face drumul invers: atob, octeți, apoi TextDecoder refac exact textul inițial, cu diacritice.
Alte forme ale mesajului
DOMException [InvalidCharacterError]: Invalid characterUncaught DOMException: Failed to execute 'btoa' on 'Window': The string to be encoded contains characters outside of the Latin1 range.InvalidCharacterError: String contains an invalid character
Cum o eviți pe viitor
- Nu da niciodată text liber (nume, adrese, JSON) direct lui
btoa: treci întâi prinTextEncoder. - Scrie două funcții ajutătoare,
inBase64(text)șidinBase64(cod), și folosește-le peste tot. - Testează codificarea cu texte care conțin ș, ț, ă, nu doar cu „test”.
- În Node poți folosi și
Buffer.from(text).toString("base64"), care lucrează direct cu UTF-8.
Întrebări frecvente
De ce merge „Târgu Mureș” fără ș, dar nu cu ș?
â are codul 226, sub 256, deci intră în Latin1. ș are codul 537, peste limită. De aceea eroarea apare doar la textele cu anumite litere.
Base64 e o formă de criptare?
Nu. E doar o codificare, oricine o poate decoda cu atob. Nu pune parole sau date secrete în Base64 crezând că le protejezi.
Erori înrudite
InvalidCharacterError: Failed to execute 'atob' on 'Window': The string to be decoded is not correctly encoded. Textul dat lui atob nu e Base64 valid: conține caractere din afara alfabetului Base64 (de exemplu prefixul data:...;base64, sau - și _ din Base64URL) ori are o lungime greșită. Scoate prefixul, transformă - în + și _ în /, și dă lui atob doar partea codificată. URIError: URI malformed `decodeURIComponent` sau `decodeURI` a primit un text cu un `%` care nu e urmat de două cifre hexazecimale valide (de exemplu „50%” sau „%E2%82”). Decodează doar texte codate corect, codează cu `encodeURIComponent` și pune decodarea într-un `try...catch` când textul vine din exterior. RangeError: Invalid code point NaN String.fromCodePoint a primit o valoare care nu e un cod Unicode valid: NaN, un număr negativ, cu zecimale sau peste 0x10FFFF. De obicei codul hexazecimal (ca 021B) a fost transformat cu Number() în loc de parseInt(cod, 16), sau un calcul a ieșit din interval. Verifică numărul înainte de apel. Învață JavaScript de la zero, cu exerciții la fiecare lecție
Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
