RangeError [ERR_ENCODING_NOT_SUPPORTED]: The "base64" encoding is not supported
TextDecoder / TextEncoder acceptă doar codificări de caractere (utf-8, utf-16le, windows-1250...), nu base64, hex sau nume inventate. Pentru base64 și hex folosește Buffer: Buffer.from(text, "base64").toString("utf8").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
new TextDecoder(eticheta) acceptă doar etichetele din standardul Encoding: codificări de caractere ca utf-8, utf-16le, iso-8859-2, windows-1250. Dacă eticheta nu e în listă, constructorul aruncă RangeError cu codul ERR_ENCODING_NOT_SUPPORTED, iar mesajul îți arată eticheta primită.
base64 și hex nu sunt codificări de caractere: sunt moduri de a scrie octeți ca text. De aceea nu le găsești în TextDecoder, dar le găsești în Buffer (buf.toString("base64"), Buffer.from(s, "hex")).
Alte cauze: nume inexistente (utf8mb4 e un termen din MySQL, nu o codificare), greșeli de scriere (windows1250 fără cratimă e acceptat, dar win-1250 nu) sau o etichetă venită dintr-un header Content-Type stricat.
De ce apare: cauzele frecvente
1Decodare base64 cu TextDecoder
const text = new TextDecoder("base64").decode(token);const text = Buffer.from(token, "base64").toString("utf8");Buffer.from(..., "base64") transformă textul base64 în octeți, iar toString("utf8") îi transformă în text.
2Nume de codificare din MySQL
new TextDecoder("utf8mb4");new TextDecoder("utf-8");utf8mb4 e numele MySQL pentru UTF-8 complet. În JavaScript e pur și simplu utf-8.
3Hex cu TextDecoder
new TextDecoder("hex").decode(date);Buffer.from(date, "hex").toString("utf8");Ca și base64, hex se decodează cu Buffer, nu cu TextDecoder.
Repară eroarea, direct în pagină
Mesajul de la serviciul de plăți vine codificat în base64. Codul încearcă să-l decodeze cu new TextDecoder("base64") și primește The "base64" encoding is not supported. Decodează-l cu Buffer, ca programul să afișeze statusul și suma.
const mesaj = "eyJzdGF0dXMiOiJwbGF0aXQiLCJzdW1hIjoxNDl9";
const json = new TextDecoder("base64").decode(Buffer.from(mesaj));
const plata = JSON.parse(json);
console.log(`Status: ${plata.status}`);
console.log(`Suma: ${plata.suma} lei`);Status: platit Suma: 149 lei
Indiciu
Buffer.from(mesaj, "base64").toString("utf8") dă textul JSON.
Reparația
const mesaj = "eyJzdGF0dXMiOiJwbGF0aXQiLCJzdW1hIjoxNDl9";
const json = Buffer.from(mesaj, "base64").toString("utf8");
const plata = JSON.parse(json);
console.log(`Status: ${plata.status}`);
console.log(`Suma: ${plata.suma} lei`);De ce merge
TextDecoder cunoaște doar codificări de caractere, iar base64 e o scriere a octeților cu litere, cifre, + și /. Buffer.from(mesaj, "base64") reface octeții originali, iar toString("utf8") îi transformă în textul JSON {"status":"platit","suma":149}, pe care îl citește apoi JSON.parse.
Alte forme ale mesajului
RangeError [ERR_ENCODING_NOT_SUPPORTED]: The "hex" encoding is not supportedRangeError [ERR_ENCODING_NOT_SUPPORTED]: The "utf8mb4" encoding is not supportedRangeError: Failed to construct 'TextDecoder': The encoding label provided ('base64') is invalid.RangeError [ERR_ENCODING_NOT_SUPPORTED]: The "win-1250" encoding is not supported
Cum o eviți pe viitor
TextDecoder/TextEncoder: pentru codificări de caractere (utf-8,windows-1250...).Buffer: pentrubase64,base64url,hex,latin1.- Validează eticheta primită din afară (header-ul
charset) și foloseșteutf-8ca valoare implicită. - Scrie numele standard, cu cratimă:
utf-8,windows-1250,iso-8859-2.
Întrebări frecvente
Care e diferența față de Unknown encoding?
Unknown encoding vine de la Buffer și fs (de exemplu buf.toString("base-64")). ERR_ENCODING_NOT_SUPPORTED vine de la TextDecoder. Fiecare are propria listă de codificări acceptate.
Există atob în Node?
Da, atob și btoa există global, dar lucrează cu text Latin-1 și strică diacriticele. Pentru text UTF-8 folosește Buffer.from(s, "base64").toString("utf8").
Erori înrudite
TypeError [ERR_UNKNOWN_ENCODING]: Unknown encoding: base-64 Numele codificării dat lui Buffer.from, toString sau unei funcții din fs nu e recunoscut de Node: de obicei e scris cu cratimă sau greșit, de exemplu "base-64" sau "utf-16". Folosește numele acceptate: "utf8", "base64", "base64url", "hex", "latin1", "utf16le", "ascii". TypeError: The encoded data was not valid for encoding utf-8 Un TextDecoder creat cu { fatal: true } a primit octeți care nu sunt UTF-8 valid, de obicei un fișier salvat în altă codificare (Windows-1250, Latin-1), cum exportă Excel-ul vechi. Decodează cu codificarea reală a fișierului, de exemplu new TextDecoder("windows-1250"), sau cere fișierul în UTF-8. DOMException [InvalidCharacterError]: Invalid character atob() a primit un text care nu e Base64 standard: de obicei Base64URL (cu - și _ în loc de + și /), cum sunt părțile unui token JWT, sau un text cu spații și alte caractere. În Node decodează cu Buffer.from(text, "base64url").toString("utf8"), care acceptă și lipsa padding-ului. Învață Node.js de la zero, cu exerciții la fiecare lecție
Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
