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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
atob și btoa sunt funcțiile din browser pentru Base64, disponibile global și în Node. atob acceptă doar alfabetul Base64 standard (A-Z, a-z, 0-9, +, / și = la final). Dacă textul conține alt caracter, aruncă o excepție de tip DOMException cu numele InvalidCharacterError, nu o eroare obișnuită de Node.
Cel mai des se întâmplă la decodarea unui JWT: părțile lui folosesc Base64URL, unde + devine - și / devine _, ca tokenul să poată sta într-un URL. Merge o vreme, până când un token conține întâmplător - sau _. Alte cauze: spații sau linii noi în text, un prefix ca data:image/png;base64, sau Bearer , ori decodarea a ceva care nu era deloc Base64.
În plus, atob întoarce un text în care fiecare octet e un caracter, deci diacriticele din UTF-8 ies stricate. Buffer.from(..., "base64url") rezolvă ambele probleme.
De ce apare: cauzele frecvente
1Payload JWT decodat cu atob
const payload = JSON.parse(atob(token.split(".")[1]));const payload = JSON.parse(Buffer.from(token.split(".")[1], "base64url").toString("utf8"));Codarea base64url înțelege - și _ și nu cere = la final. toString("utf8") păstrează corect diacriticele.
2Prefix sau spații în text
atob("data:image/png;base64,iVBORw0KGgo=");const base64 = sir.split(",")[1].replace(/\s/g, "");
const octeti = Buffer.from(base64, "base64");Doar partea de după virgulă e Base64; spațiile și liniile noi trebuie eliminate înainte.
3Decodarea unui header Authorization întreg
atob(req.headers.authorization);const [, credentiale] = req.headers.authorization.split(" ");
const [user, parola] = Buffer.from(credentiale, "base64").toString("utf8").split(":");Header-ul are forma Basic dXNlcjpwYXJvbGE=; spațiul și cuvântul Basic nu sunt Base64.
Repară eroarea, direct în pagină
Programul afișează datele din payload-ul unui token JWT, decodat cu atob, și dă DOMException [InvalidCharacterError]: Invalid character, pentru că payload-ul conține caracterul _ din Base64URL. Decodează payload-ul cu Buffer și codarea potrivită, ca programul să afișeze utilizatorul și pagina de revenire.
const token = "eyJhbGciOiJIUzI1NiJ9.eyJpZCI6NDIsIm51bWUiOiJBbmEiLCJyZXZlbmlyZSI6Ii9jb3M_aWQ9NyJ9.c2VtbmF0dXJh";
try {
const parte = token.split(".")[1];
const payload = JSON.parse(atob(parte));
console.log(`Utilizator: ${payload.nume} (id ${payload.id})`);
console.log(`Revenire la: ${payload.revenire}`);
} catch (err) {
console.error(`${err.name}: ${err.message}`);
process.exitCode = 1;
}Utilizator: Ana (id 42) Revenire la: /cos?id=7
Indiciu
Buffer.from(parte, "base64url").toString("utf8") decodează alfabetul cu - și _.
Reparația
const token = "eyJhbGciOiJIUzI1NiJ9.eyJpZCI6NDIsIm51bWUiOiJBbmEiLCJyZXZlbmlyZSI6Ii9jb3M_aWQ9NyJ9.c2VtbmF0dXJh";
try {
const parte = token.split(".")[1];
const payload = JSON.parse(Buffer.from(parte, "base64url").toString("utf8"));
console.log(`Utilizator: ${payload.nume} (id ${payload.id})`);
console.log(`Revenire la: ${payload.revenire}`);
} catch (err) {
console.error(`${err.name}: ${err.message}`);
process.exitCode = 1;
}De ce merge
Părțile unui JWT sunt codate în Base64URL, unde / din Base64 devine _. Payload-ul acestui token conține _, caracter pe care atob nu îl acceptă. Codarea base64url a lui Buffer înțelege exact acest alfabet și nu cere = la final, iar toString("utf8") produce textul JSON corect, inclusiv pentru diacritice. Reține: decodarea doar citește datele, nu verifică semnătura tokenului.
Alte forme ale mesajului
InvalidCharacterError: Invalid characterDOMException [InvalidCharacterError]: The string to be decoded is not correctly encoded.InvalidCharacterError: Failed to execute 'atob' on 'Window': The string to be decoded is not correctly encoded.
Cum o eviți pe viitor
- În codul Node, folosește
Buffer.from(text, "base64")sau"base64url"în loc deatob/btoa. - Pentru JWT, folosește o bibliotecă (de exemplu
jose), care decodează și verifică semnătura; decodarea manuală e potrivită doar pentru afișare. - Curăță textul înainte de decodare: prefixe, spații, linii noi.
Întrebări frecvente
De ce mergea cu alte tokenuri?
Base64 și Base64URL diferă doar prin două caractere. Un token fără - și _ (și cu lungime potrivită) e valid în ambele alfabete, așa că atob mergea întâmplător.
Decodarea payload-ului verifică tokenul?
Nu. Oricine poate citi payload-ul unui JWT. Tokenul e de încredere doar după verificarea semnăturii cu cheia secretă (de exemplu cu HMAC sau cu o bibliotecă JWT).
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 [ERR_INVALID_ARG_TYPE]: The first argument must be of type string or an instance of Buffer, ArrayBuffer, or Array or an Array-like Object. Received undefined Buffer.from() a primit undefined (sau un număr, un obiect) în loc de text sau octeți. De obicei valoarea vine dintr-o proprietate inexistentă, de exemplu req.headers.Authorization, când Node păstrează antetele cu litere mici. Verifică valoarea înainte de Buffer.from. SyntaxError: Unexpected token 'o', "[object Obj"... is not valid JSON Serverul a primit textul "[object Object]" în loc de JSON, pentru că clientul a trimis un obiect în body fără JSON.stringify. Express răspunde cu 400 Bad Request. Scrie body: JSON.stringify(date) și antetul Content-Type: application/json. Î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.
