TypeError: Failed to execute 'decode' on 'TextDecoder': The encoded data was not valid.
Un TextDecoder creat cu { fatal: true } a primit octeți care nu sunt valizi în codificarea aleasă, de obicei un fișier salvat în windows-1250 sau ISO-8859-2 citit ca UTF-8. Decodează cu codificarea reală a fișierului: new TextDecoder("windows-1250").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
TextDecoder transformă octeți în text, după o codificare (implicit UTF-8). Fără opțiuni, octeții invalizi sunt înlocuiți cu caracterul �. Cu { fatal: true }, decodorul aruncă eroare la primul octet invalid: în Chrome Failed to execute 'decode' on 'TextDecoder': The encoded data was not valid., iar în Node The encoded data was not valid for encoding utf-8.
Cazul tipic în România: un CSV exportat din Excel sau dintr-un program de contabilitate vechi, salvat în windows-1250 (sau ISO-8859-2). Literele ă, â, î sunt acolo câte un singur octet (de exemplu â = 0xE2), care în UTF-8 ar trebui să fie începutul unei secvențe de doi sau trei octeți. Decodorul UTF-8 vede o secvență ruptă și oprește citirea.
Afli codificarea din documentația sursei sau încercând: dacă textul decodat cu windows-1250 arată corect, acolo e răspunsul. Pe termen lung, cere exporturile în UTF-8.
De ce apare: cauzele frecvente
1CSV în windows-1250 citit ca UTF-8
const text = new TextDecoder("utf-8", { fatal: true }).decode(octeti);const text = new TextDecoder("windows-1250").decode(octeti);Decodorul folosește codificarea reală a fișierului, deci fiecare octet devine litera corectă.
2Text tăiat la mijlocul unui caracter
const parte = new TextDecoder("utf-8", { fatal: true }).decode(bucata);const dec = new TextDecoder("utf-8", { fatal: true });
const parte = dec.decode(bucata, { stream: true });La citirea pe bucăți, un caracter de mai mulți octeți poate fi împărțit. Cu stream: true, decodorul păstrează octeții rămași pentru bucata următoare.
3Date binare tratate ca text
new TextDecoder("utf-8", { fatal: true }).decode(await r.arrayBuffer()); // o imagineconst tip = r.headers.get("content-type");
if (tip.startsWith("text/")) new TextDecoder().decode(await r.arrayBuffer());O imagine sau un fișier zip nu e text; verifică tipul înainte de decodare.
Repară eroarea, direct în pagină
Octeții vin dintr-un CSV salvat în windows-1250, iar codul îi citește ca UTF-8 cu fatal: true, ceea ce dă TypeError: The encoded data was not valid.... Repară decodorul ca programul să afișeze Produs: Pâine.
const octeti = new Uint8Array([0x50, 0xe2, 0x69, 0x6e, 0x65]);
const decodor = new TextDecoder("utf-8", { fatal: true });
console.log(`Produs: ${decodor.decode(octeti)}`);Produs: Pâine
Indiciu
Creează TextDecoder cu codificarea reală a fișierului: "windows-1250".
Reparația
const octeti = new Uint8Array([0x50, 0xe2, 0x69, 0x6e, 0x65]);
const decodor = new TextDecoder("windows-1250");
console.log(`Produs: ${decodor.decode(octeti)}`);De ce merge
În windows-1250, litera â e un singur octet, 0xE2. În UTF-8, 0xE2 începe o secvență de trei octeți, iar octeții care urmează nu o continuă corect, deci decodorul cu fatal: true se oprește. Decodat cu codificarea reală, fiecare octet devine litera lui și textul e „Pâine”.
Alte forme ale mesajului
TypeError: The encoded data was not valid for encoding utf-8TypeError [ERR_ENCODING_INVALID_ENCODED_DATA]: The encoded data was not valid for encoding utf-8TypeError: Decoding failed.TypeError: TextDecoder.decode: Decoding failed.
Cum o eviți pe viitor
- Cere și produce fișiere în UTF-8; la export din Excel alege „CSV UTF-8”.
- Folosește
{ fatal: true }când vrei să afli că datele sunt stricate, nu să le corupi în tăcere cu�. - La citirea pe bucăți, folosește
decode(bucata, { stream: true })și un apel finaldecode(). - Notează codificarea fiecărei surse externe de date în documentația proiectului.
Întrebări frecvente
De ce fără fatal: true nu primesc eroare?
Implicit, octeții invalizi sunt înlocuiți cu �, iar decodarea continuă. Textul pare citit, dar literele cu diacritice sunt pierdute.
Diacriticele ș și ț există în windows-1250?
Nu în forma corectă, cu virgulă: acolo există doar variantele cu sedilă dedesubt, nu cu virgulă. De aceea fișierele vechi au des diacritice greșite și merită convertite în UTF-8.
Erori înrudite
RangeError: Failed to construct 'TextDecoder': The encoding label provided ('win-1250') is invalid. Numele codificării dat lui TextDecoder nu e recunoscut, de obicei o variantă scrisă de mână ("win-1250", "latin-2", "utf8x"). Folosește un nume standard: "utf-8", "windows-1250", "iso-8859-2", "utf-16le". 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. 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ă. Î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.
