...
Eroare JavaScript · Date binare: ArrayBuffer, TypedArray și DataView

TypeError: Failed to execute 'decode' on 'TextDecoder': The encoded data was not valid.

Pe scurt

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

Greșit
JavaScript
const text = new TextDecoder("utf-8", { fatal: true }).decode(octeti);
Corect
JavaScript
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

Greșit
JavaScript
const parte = new TextDecoder("utf-8", { fatal: true }).decode(bucata);
Corect
JavaScript
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

Greșit
JavaScript
new TextDecoder("utf-8", { fatal: true }).decode(await r.arrayBuffer()); // o imagine
Corect
JavaScript
const 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ă tu

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.

Codul care dă eroarea
JavaScript
const octeti = new Uint8Array([0x50, 0xe2, 0x69, 0x6e, 0x65]);

const decodor = new TextDecoder("utf-8", { fatal: true });
console.log(`Produs: ${decodor.decode(octeti)}`);
După reparație, programul afișează
Produs: Pâine
Indiciu

Creează TextDecoder cu codificarea reală a fișierului: "windows-1250".

Alte forme ale mesajului

  • TypeError: The encoded data was not valid for encoding utf-8
  • TypeError [ERR_ENCODING_INVALID_ENCODED_DATA]: The encoded data was not valid for encoding utf-8
  • TypeError: 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 final decode().
  • 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

← Toate erorile JavaScript

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.