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

TypeError [ERR_UNKNOWN_ENCODING]: Unknown encoding: base-64

Pe scurt

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

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Node transformă text în octeți și invers folosind o codificare (encoding), dată ca text: Buffer.from(text, "base64"), buf.toString("hex"), fs.readFileSync(f, "utf8"). Lista codificărilor acceptate e scurtă: utf8 (sau utf-8), utf16le, latin1, base64, base64url, hex, ascii, binary, ucs2.

Mesajul apare când numele nu e în listă: base-64, utf-16, utf8mb4 (din MySQL) sau un argument pus pe poziția greșită. La funcțiile din fs, aceeași greșeală dă varianta ERR_INVALID_ARG_VALUE: The argument 'encoding' is invalid encoding. Valoarea de după două puncte din mesaj e exact textul primit, deci îl compari ușor cu lista.

De ce apare: cauzele frecvente

1Cratimă în numele codificării

Greșit
JavaScript
Buffer.from(token, "base-64").toString("utf8");
Corect
JavaScript
Buffer.from(token, "base64").toString("utf8");

Doar utf-8 are și varianta cu cratimă; base64 se scrie legat.

2UTF-16 cu numele din alte limbaje

Greșit
JavaScript
buf.toString("utf-16");
Corect
JavaScript
buf.toString("utf16le");

Node știe doar UTF-16 little-endian, cu numele utf16le (sau ucs2).

3Codificarea pusă în locul altui argument

Greșit
JavaScript
fs.writeFileSync("a.txt", "utf8", text);
Corect
JavaScript
fs.writeFileSync("a.txt", text, "utf8");

La writeFileSync, ordinea este: cale, date, opțiuni (sau codificare).

Repară tu

Repară eroarea, direct în pagină

Programul decodifică un token Base64 primit de la un API și dă TypeError [ERR_UNKNOWN_ENCODING]: Unknown encoding: base-64. Corectează numele codificării, ca programul să afișeze textul decodificat și numele utilizatorului din el.

Codul care dă eroarea
JavaScript
const token = Buffer.from(JSON.stringify({ user: "ana", rol: "admin" })).toString("base64");
console.log(`Token: ${token}`);

const text = Buffer.from(token, "base-64").toString("utf8");
console.log(`Decodificat: ${text}`);
console.log(`Utilizator: ${JSON.parse(text).user}`);
După reparație, programul afișează
Token: eyJ1c2VyIjoiYW5hIiwicm9sIjoiYWRtaW4ifQ==
Decodificat: {"user":"ana","rol":"admin"}
Utilizator: ana
Indiciu

Codificarea Base64 se scrie în Node legat, cu litere mici.

Alte forme ale mesajului

  • TypeError [ERR_UNKNOWN_ENCODING]: Unknown encoding: utf-16
  • TypeError [ERR_INVALID_ARG_VALUE]: The argument 'encoding' is invalid encoding. Received 'utf-16'
  • TypeError [ERR_UNKNOWN_ENCODING]: Unknown encoding: utf8mb4

Cum o eviți pe viitor

  • Folosește doar codificările din documentația Buffer: utf8, base64, base64url, hex, latin1, utf16le.
  • Pune codificările folosite des în constante.
  • Pentru texte în română, utf8 acoperă toate diacriticele; nu ai nevoie de alte codificări.
  • Când codificarea vine din configurare, verific-o cu Buffer.isEncoding(nume) înainte de folosire.

Întrebări frecvente

Care e diferența dintre base64 și base64url?

base64url înlocuiește + și / cu - și _ și nu folosește = la final, ca rezultatul să poată sta într-un URL. JWT-urile folosesc base64url.

Cum citesc un CSV salvat de Excel în UTF-16?

Cu fs.readFileSync(fisier, "utf16le"). Dacă primul caracter e un BOM (\uFEFF), elimină-l cu text.replace(/^\uFEFF/, "").

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.