...
Eroare Node.js · Buffer, crypto și assert

RangeError [ERR_ENCODING_NOT_SUPPORTED]: The "base64" encoding is not supported

Pe scurt

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

Greșit
JavaScript
const text = new TextDecoder("base64").decode(token);
Corect
JavaScript
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

Greșit
JavaScript
new TextDecoder("utf8mb4");
Corect
JavaScript
new TextDecoder("utf-8");

utf8mb4 e numele MySQL pentru UTF-8 complet. În JavaScript e pur și simplu utf-8.

3Hex cu TextDecoder

Greșit
JavaScript
new TextDecoder("hex").decode(date);
Corect
JavaScript
Buffer.from(date, "hex").toString("utf8");

Ca și base64, hex se decodează cu Buffer, nu cu TextDecoder.

Repară tu

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.

Codul care dă eroarea
JavaScript
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`);
După reparație, programul afișează
Status: platit
Suma: 149 lei
Indiciu

Buffer.from(mesaj, "base64").toString("utf8") dă textul JSON.

Alte forme ale mesajului

  • RangeError [ERR_ENCODING_NOT_SUPPORTED]: The "hex" encoding is not supported
  • RangeError [ERR_ENCODING_NOT_SUPPORTED]: The "utf8mb4" encoding is not supported
  • RangeError: 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: pentru base64, base64url, hex, latin1.
  • Validează eticheta primită din afară (header-ul charset) și folosește utf-8 ca 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

← Toate erorile Node.js

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ță 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.