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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
atob decodează un text Base64, al cărui alfabet are doar litere, cifre, +, / și = pentru completare. Dacă textul conține alte caractere sau are o lungime imposibilă (de exemplu un singur caracter în plus după un grup de patru), atob aruncă eroarea: în Chrome The string to be decoded is not correctly encoded, în Node DOMException [InvalidCharacterError]: Invalid character. Spațiile și liniile noi sunt ignorate, deci nu ele sunt problema.
Trei situații produc aproape toate cazurile. Un data URL dat întreg (data:image/png;base64,iVBOR...), unde :, ; și , nu fac parte din Base64. Un text Base64URL, folosit în JWT și în link-uri, care înlocuiește + cu - și / cu _. Un text care nu e Base64 deloc: un ID, un JSON sau un token tăiat.
Afișează textul exact și caută primul caracter care nu e în alfabet.
De ce apare: cauzele frecvente
1Data URL dat întreg lui atob
const date = atob("data:text/plain;base64,U2FsdXQ=");const url = "data:text/plain;base64,U2FsdXQ=";
const date = atob(url.split(",")[1]);Doar partea de după virgulă e Base64. Prefixul descrie tipul datelor.
2Partea dintr-un JWT, în Base64URL
const payload = atob(token.split(".")[1]);const parte = token.split(".")[1].replace(/-/g, "+").replace(/_/g, "/");
const payload = atob(parte);JWT folosește Base64URL. După înlocuirea lui - și _, textul devine Base64 standard.
3Text care nu e Base64
const id = atob(produs.id); // id = "PRD-2024"const id = produs.id;Nu orice text lung e Base64. Decodează doar ce știi sigur că a fost codificat cu btoa.
Repară eroarea, direct în pagină
Funcția citesteDataUrl primește un data URL cu un mesaj text, dar dă tot URL-ul lui atob, care aruncă InvalidCharacterError (în Node: Invalid character). Repară funcția ca să decodeze doar partea Base64 de după virgulă, iar programul să afișeze mesajul.
function citesteDataUrl(url) {
return atob(url);
}
const url = "data:text/plain;base64,U2FsdXQsIGx1bWUh";
console.log(`Mesaj: ${citesteDataUrl(url)}`);Mesaj: Salut, lume!
Indiciu
Partea codificată e cea de după prima virgulă din data URL.
Reparația
function citesteDataUrl(url) {
const parteBase64 = url.slice(url.indexOf(",") + 1);
return atob(parteBase64);
}
const url = "data:text/plain;base64,U2FsdXQsIGx1bWUh";
console.log(`Mesaj: ${citesteDataUrl(url)}`);De ce merge
Un data URL are un antet (data:text/plain;base64,) și abia apoi datele codificate. Caracterele :, ; și , din antet nu fac parte din alfabetul Base64, de aceea atob respingea textul. slice de la poziția de după prima virgulă păstrează doar U2FsdXQsIGx1bWUh, care e Base64 valid și se decodează în mesajul original.
Alte forme ale mesajului
DOMException [InvalidCharacterError]: Invalid characterUncaught DOMException: Failed to execute 'atob' on 'Window': The string to be decoded is not correctly encoded.InvalidCharacterError: String contains an invalid character
Cum o eviți pe viitor
- Separă clar formatele: data URL, Base64 standard, Base64URL. Decodează fiecare cu pașii lui.
- Pentru JWT, folosește o bibliotecă testată sau o funcție ajutătoare care face înlocuirile.
- Pune
atobîntr-untry/catchcând textul vine de la utilizator sau din rețea. - După
atob, foloseșteTextDecoderdacă datele originale conțineau diacritice.
Întrebări frecvente
De ce merge în Node cu Buffer.from(text, "base64")?
Buffer e mai permisiv: ignoră caracterele invalide și acceptă și Base64URL. atob respectă strict standardul web și aruncă eroare.
Trebuie să adaug = la final?
De obicei nu: atob acceptă și texte fără completare, cât timp lungimea nu e de forma 4k + 1. Problema e aproape mereu un caracter din afara alfabetului.
Erori înrudite
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. SyntaxError: "undefined" is not valid JSON Ai dat lui `JSON.parse` valoarea `undefined` în loc de un text JSON, de obicei o variabilă goală, o proprietate scrisă greșit sau un rezultat lipsă. `JSON.parse` o transformă în textul „undefined”, care nu e JSON. Verifică de unde vine valoarea și tratează cazul în care lipsește. 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. Î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.
