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".
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
Buffer.from(token, "base-64").toString("utf8");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
buf.toString("utf-16");buf.toString("utf16le");Node știe doar UTF-16 little-endian, cu numele utf16le (sau ucs2).
3Codificarea pusă în locul altui argument
fs.writeFileSync("a.txt", "utf8", text);fs.writeFileSync("a.txt", text, "utf8");La writeFileSync, ordinea este: cale, date, opțiuni (sau codificare).
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.
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}`);Token: eyJ1c2VyIjoiYW5hIiwicm9sIjoiYWRtaW4ifQ==
Decodificat: {"user":"ana","rol":"admin"}
Utilizator: anaIndiciu
Codificarea Base64 se scrie în Node legat, cu litere mici.
Reparația
const token = Buffer.from(JSON.stringify({ user: "ana", rol: "admin" })).toString("base64");
console.log(`Token: ${token}`);
const text = Buffer.from(token, "base64").toString("utf8");
console.log(`Decodificat: ${text}`);
console.log(`Utilizator: ${JSON.parse(text).user}`);De ce merge
Buffer.from(text, codificare) interpretează textul după codificarea dată și obține octeții. base-64 nu e un nume pe care Node îl cunoaște, așa că aruncă ERR_UNKNOWN_ENCODING. Cu base64, șirul e transformat înapoi în octeții originali, iar toString("utf8") îi transformă în textul JSON. Atenție: Base64 este doar o codificare, nu o criptare; oricine poate decodifica tokenul.
Alte forme ale mesajului
TypeError [ERR_UNKNOWN_ENCODING]: Unknown encoding: utf-16TypeError [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ă,
utf8acoperă 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
Error: Digest method not supported Numele algoritmului dat lui crypto.createHash sau createHmac nu e recunoscut, de obicei o greșeală de scriere: "sha265" în loc de "sha256" sau "SHA-256" cu cratimă. Folosește un nume valid, de exemplu "sha256", "sha512" sau "md5". TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received an instance of Object Încerci să scrii în fișier un obiect sau un tablou direct, dar writeFileSync și appendFileSync acceptă doar text sau Buffer. Transformă datele în text: JSON.stringify(date, null, 2) pentru JSON, sau String(numar) pentru numere. TypeError [ERR_INVALID_ARG_TYPE]: The "key" argument must be of type string or an instance of ArrayBuffer, Buffer, TypedArray, DataView, KeyObject, or CryptoKey. Received undefined Cheia secretă dată lui crypto.createHmac (sau unei funcții de semnare, ca la JWT) e undefined: variabila de mediu nu e setată, fișierul de configurare nu are cheia sau numele proprietății e greșit. Verifică de unde vine cheia și oprește aplicația cu un mesaj clar dacă lipsește. Î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.
