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

RangeError: Failed to construct 'TextDecoder': The encoding label provided ('win-1250') is invalid.

Pe scurt

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

Greșit
JavaScript
new TextDecoder("win-1250");
Corect
JavaScript
new TextDecoder("windows-1250");

Numele standard e windows-1250; cp1250 e un alias acceptat, dar win-1250 nu.

2Alias inexistent pentru Latin-2

Greșit
JavaScript
new TextDecoder("latin-2");
Corect
JavaScript
new TextDecoder("latin2");

Aliasul acceptat e fără cratimă (latin2), iar numele complet e iso-8859-2.

3Etichetă venită din date

Greșit
JavaScript
new TextDecoder(setari.codificare);
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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)}`);
După reparație, programul afișează
Codificare: windows-1250
Text: Pâine
Indiciu

Numele standard al codificării este "windows-1250".

Alte forme ale mesajului

  • RangeError [ERR_ENCODING_NOT_SUPPORTED]: The "win-1250" encoding is not supported
  • RangeError: The "latin-2" encoding is not supported
  • RangeError: TextDecoder constructor: "win-1250" is not a supported encoding name
  • RangeError: 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/catch cu 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

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