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".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
new TextDecoder(eticheta) primește numele codificării ca text. Lista de nume acceptate e fixă, definită de standardul Encoding: de exemplu "utf-8" (sau "utf8"), "windows-1250" (sau "cp1250"), "iso-8859-2" (sau "latin2"), "utf-16le". Majusculele și spațiile de la capete nu contează. Orice alt nume aruncă: în Chrome The encoding label provided ('win-1250') is invalid., în Node The "win-1250" encoding is not supported.
Numele greșite apar când sunt scrise din memorie ("win-1250", "latin-2", "utf-8-bom") sau copiate din alte unelte, care folosesc denumiri proprii ("Windows Central European", "UTF-8 with BOM"). Și TextEncoder e diferit: el codifică doar în UTF-8 și nu primește etichetă.
Dacă eticheta vine din date (antetul Content-Type, o setare), prinde eroarea și folosește UTF-8 ca rezervă.
De ce apare: cauzele frecvente
1Nume de codificare scris din memorie
new TextDecoder("win-1250");new TextDecoder("windows-1250");Numele standard e windows-1250; cp1250 e un alias acceptat, dar win-1250 nu.
2Alias inexistent pentru Latin-2
new TextDecoder("latin-2");new TextDecoder("latin2");Aliasul acceptat e fără cratimă (latin2), iar numele complet e iso-8859-2.
3Etichetă venită din date
new TextDecoder(setari.codificare);let dec;
try { dec = new TextDecoder(setari.codificare); } catch { dec = new TextDecoder("utf-8"); }Când numele vine din exterior, eroarea e tratată și decodarea continuă cu UTF-8.
Repară eroarea, direct în pagină
Programul decodează un export în codificarea Windows pentru Europa Centrală, dar numele scris în cod dă RangeError: ... The encoding label provided ('win-1250') is invalid. (în Node: The "win-1250" encoding is not supported). Repară eticheta ca programul să afișeze Codificare: windows-1250 și Text: Pâine.
const octeti = new Uint8Array([0x50, 0xe2, 0x69, 0x6e, 0x65]);
const decodor = new TextDecoder("win-1250");
console.log(`Codificare: ${decodor.encoding}`);
console.log(`Text: ${decodor.decode(octeti)}`);Codificare: windows-1250 Text: Pâine
Indiciu
Numele standard al codificării este "windows-1250".
Reparația
const octeti = new Uint8Array([0x50, 0xe2, 0x69, 0x6e, 0x65]);
const decodor = new TextDecoder("windows-1250");
console.log(`Codificare: ${decodor.encoding}`);
console.log(`Text: ${decodor.decode(octeti)}`);De ce merge
TextDecoder acceptă doar etichetele din standardul Encoding, iar win-1250 nu e printre ele. windows-1250 e numele standard, iar decodor.encoding confirmă că a fost recunoscut. Octetul 0xE2 devine â, deci textul decodat e „Pâine”. Aceeași etichetă funcționează identic în browser și în Node.
Alte forme ale mesajului
RangeError [ERR_ENCODING_NOT_SUPPORTED]: The "win-1250" encoding is not supportedRangeError: The "latin-2" encoding is not supportedRangeError: TextDecoder constructor: "win-1250" is not a supported encoding nameRangeError: Failed to construct 'TextDecoder': The encoding label provided ('utf8x') is invalid.
Cum o eviți pe viitor
- Copiază numele codificărilor din standard (WHATWG Encoding), nu din meniurile altor programe.
- Ține etichetele într-o constantă (
const CODIFICARE_EXPORT = "windows-1250") folosită peste tot. - Pentru etichete venite din date, folosește
try/catchcu rezervă UTF-8. - Verifică ce nume a fost recunoscut cu
decodor.encoding, care întoarce forma standard.
Întrebări frecvente
Cum văd numele standard al unei etichete?
Creează decodorul și citește decodor.encoding: pentru "cp1250" întoarce "windows-1250", pentru "latin2" întoarce "iso-8859-2".
TextEncoder acceptă alte codificări?
Nu. TextEncoder codifică doar în UTF-8. Pentru alte codificări la scriere ai nevoie de o bibliotecă dedicată.
Erori înrudite
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"). RangeError: Incorrect locale information provided Ai dat lui `toLocaleString`, `toLocaleDateString` sau `Intl.*` un cod de limbă scris greșit, de exemplu `"ro_RO"` (cu underscore) sau `"romana"`. Codurile valide au forma BCP 47 cu cratimă: `"ro-RO"`, `"ro"`, `"en-US"`. RangeError: The normalization form should be one of NFC, NFD, NFKC, NFKD. Ai apelat text.normalize(...) cu o formă necunoscută, de obicei scrisă cu litere mici ("nfd") sau greșit ("NDF"). Valorile acceptate sunt exact "NFC", "NFD", "NFKC", "NFKD", cu majuscule. Pentru eliminarea diacriticelor se folosește normalize("NFD"). Î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.
