...
Eroare JavaScript · Șiruri, expresii regulate și URI

InvalidCharacterError: Failed to execute 'atob' on 'Window': The string to be decoded is not correctly encoded.

Pe scurt

Textul dat lui atob nu e Base64 valid: conține caractere din afara alfabetului Base64 (de exemplu prefixul data:...;base64, sau - și _ din Base64URL) ori are o lungime greșită. Scoate prefixul, transformă - în + și _ în /, și dă lui atob doar partea codificată.

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

Ce înseamnă

atob decodează un text Base64, al cărui alfabet are doar litere, cifre, +, / și = pentru completare. Dacă textul conține alte caractere sau are o lungime imposibilă (de exemplu un singur caracter în plus după un grup de patru), atob aruncă eroarea: în Chrome The string to be decoded is not correctly encoded, în Node DOMException [InvalidCharacterError]: Invalid character. Spațiile și liniile noi sunt ignorate, deci nu ele sunt problema.

Trei situații produc aproape toate cazurile. Un data URL dat întreg (data:image/png;base64,iVBOR...), unde :, ; și , nu fac parte din Base64. Un text Base64URL, folosit în JWT și în link-uri, care înlocuiește + cu - și / cu _. Un text care nu e Base64 deloc: un ID, un JSON sau un token tăiat.

Afișează textul exact și caută primul caracter care nu e în alfabet.

De ce apare: cauzele frecvente

1Data URL dat întreg lui atob

Greșit
JavaScript
const date = atob("data:text/plain;base64,U2FsdXQ=");
Corect
JavaScript
const url = "data:text/plain;base64,U2FsdXQ=";
const date = atob(url.split(",")[1]);

Doar partea de după virgulă e Base64. Prefixul descrie tipul datelor.

2Partea dintr-un JWT, în Base64URL

Greșit
JavaScript
const payload = atob(token.split(".")[1]);
Corect
JavaScript
const parte = token.split(".")[1].replace(/-/g, "+").replace(/_/g, "/");
const payload = atob(parte);

JWT folosește Base64URL. După înlocuirea lui - și _, textul devine Base64 standard.

3Text care nu e Base64

Greșit
JavaScript
const id = atob(produs.id); // id = "PRD-2024"
Corect
JavaScript
const id = produs.id;

Nu orice text lung e Base64. Decodează doar ce știi sigur că a fost codificat cu btoa.

Repară tu

Repară eroarea, direct în pagină

Funcția citesteDataUrl primește un data URL cu un mesaj text, dar dă tot URL-ul lui atob, care aruncă InvalidCharacterError (în Node: Invalid character). Repară funcția ca să decodeze doar partea Base64 de după virgulă, iar programul să afișeze mesajul.

Codul care dă eroarea
JavaScript
function citesteDataUrl(url) {
  return atob(url);
}

const url = "data:text/plain;base64,U2FsdXQsIGx1bWUh";
console.log(`Mesaj: ${citesteDataUrl(url)}`);
După reparație, programul afișează
Mesaj: Salut, lume!
Indiciu

Partea codificată e cea de după prima virgulă din data URL.

Alte forme ale mesajului

  • DOMException [InvalidCharacterError]: Invalid character
  • Uncaught DOMException: Failed to execute 'atob' on 'Window': The string to be decoded is not correctly encoded.
  • InvalidCharacterError: String contains an invalid character

Cum o eviți pe viitor

  • Separă clar formatele: data URL, Base64 standard, Base64URL. Decodează fiecare cu pașii lui.
  • Pentru JWT, folosește o bibliotecă testată sau o funcție ajutătoare care face înlocuirile.
  • Pune atob într-un try/catch când textul vine de la utilizator sau din rețea.
  • După atob, folosește TextDecoder dacă datele originale conțineau diacritice.

Întrebări frecvente

De ce merge în Node cu Buffer.from(text, "base64")?

Buffer e mai permisiv: ignoră caracterele invalide și acceptă și Base64URL. atob respectă strict standardul web și aruncă eroare.

Trebuie să adaug = la final?

De obicei nu: atob acceptă și texte fără completare, cât timp lungimea nu e de forma 4k + 1. Problema e aproape mereu un caracter din afara alfabetului.

Erori înrudite

← Toate erorile JavaScript

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ță JavaScript de la zero, cu exerciții la fiecare lecție

Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.