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

DOMException [InvalidCharacterError]: Invalid character

Pe scurt

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

Greșit
JavaScript
const payload = JSON.parse(atob(token.split(".")[1]));
Corect
JavaScript
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

Greșit
JavaScript
atob("data:image/png;base64,iVBORw0KGgo=");
Corect
JavaScript
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

Greșit
JavaScript
atob(req.headers.authorization);
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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;
}
După reparație, programul afișează
Utilizator: Ana (id 42)
Revenire la: /cos?id=7
Indiciu

Buffer.from(parte, "base64url").toString("utf8") decodează alfabetul cu - și _.

Alte forme ale mesajului

  • InvalidCharacterError: Invalid character
  • DOMException [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 de atob/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

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