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

InvalidCharacterError: Failed to execute 'btoa' on 'Window': The string to be encoded contains characters outside of the Latin1 range.

Pe scurt

btoa acceptă doar caractere Latin1 (coduri 0–255), iar textul tău conține diacritice ca ș, ț, ă sau emoji. Transformă întâi textul în octeți UTF-8 cu TextEncoder, apoi codifică octeții în Base64. La decodare, faci invers cu atob și TextDecoder.

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

Ce înseamnă

btoa („binary to ASCII”) codifică în Base64 un text în care fiecare caracter reprezintă un octet, deci are cod între 0 și 255 (setul Latin1). Literele românești ș, ț, ă (ă = 259, ș = 537, ț = 539) și emoji au coduri mai mari, așa că btoa refuză textul: în Chrome mesajul e The string to be encoded contains characters outside of the Latin1 range, în Node e DOMException [InvalidCharacterError]: Invalid character.

Curios e că â și î merg (au coduri sub 256), iar ș și ț nu, de aceea eroarea apare doar la unele texte: un nume ca „Ion” trece, „Ștefan” pică.

Reparația corectă: transformi textul în octeți UTF-8 cu new TextEncoder().encode(text), faci din octeți un text binar (un caracter per octet) și abia pe acesta îl dai lui btoa. La citire, atob dă textul binar, din care refaci octeții și îi decodezi cu TextDecoder. Nu folosi unescape(encodeURIComponent(...)): funcționează, dar unescape e învechit.

De ce apare: cauzele frecvente

1Text cu diacritice dat direct lui btoa

Greșit
JavaScript
const cod = btoa("Ștefan");
Corect
JavaScript
const octeti = new TextEncoder().encode("Ștefan");
const cod = btoa(String.fromCharCode(...octeti));

Fiecare octet UTF-8 are valoare 0–255, deci textul binar format din ei e acceptat de btoa.

2Obiect JSON cu diacritice salvat în Base64

Greșit
JavaScript
const token = btoa(JSON.stringify({ oras: "Brașov" }));
Corect
JavaScript
const json = JSON.stringify({ oras: "Brașov" });
const token = btoa(String.fromCharCode(...new TextEncoder().encode(json)));

JSON-ul păstrează diacriticele, deci trebuie trecut prin TextEncoder înainte de btoa.

3Decodare fără TextDecoder

Greșit
JavaScript
const text = atob(cod); // dă „È™tefan”
Corect
JavaScript
const binar = atob(cod);
const octeti = Uint8Array.from(binar, (c) => c.charCodeAt(0));
const text = new TextDecoder().decode(octeti);

Fără TextDecoder, fiecare octet devine un caracter separat și diacriticele apar stricate.

Repară tu

Repară eroarea, direct în pagină

Funcția inBase64 codifică un mesaj pentru un link, dar textul are diacritice și btoa aruncă InvalidCharacterError (în Node: Invalid character). Repară funcția astfel încât textul să fie transformat întâi în octeți UTF-8 cu TextEncoder, iar programul să afișeze codul Base64 și textul decodat înapoi.

Codul care dă eroarea
JavaScript
function inBase64(text) {
  return btoa(text);
}

function dinBase64(cod) {
  const binar = atob(cod);
  const octeti = Uint8Array.from(binar, (c) => c.charCodeAt(0));
  return new TextDecoder().decode(octeti);
}

const cod = inBase64("mere și pere");
console.log(cod);
console.log(dinBase64(cod));
După reparație, programul afișează
bWVyZSDImWkgcGVyZQ==
mere și pere
Indiciu

Fă din octeții UTF-8 un text binar cu String.fromCharCode, apoi dă-l lui btoa.

Alte forme ale mesajului

  • DOMException [InvalidCharacterError]: Invalid character
  • Uncaught DOMException: Failed to execute 'btoa' on 'Window': The string to be encoded contains characters outside of the Latin1 range.
  • InvalidCharacterError: String contains an invalid character

Cum o eviți pe viitor

  • Nu da niciodată text liber (nume, adrese, JSON) direct lui btoa: treci întâi prin TextEncoder.
  • Scrie două funcții ajutătoare, inBase64(text) și dinBase64(cod), și folosește-le peste tot.
  • Testează codificarea cu texte care conțin ș, ț, ă, nu doar cu „test”.
  • În Node poți folosi și Buffer.from(text).toString("base64"), care lucrează direct cu UTF-8.

Întrebări frecvente

De ce merge „Târgu Mureș” fără ș, dar nu cu ș?

â are codul 226, sub 256, deci intră în Latin1. ș are codul 537, peste limită. De aceea eroarea apare doar la textele cu anumite litere.

Base64 e o formă de criptare?

Nu. E doar o codificare, oricine o poate decoda cu atob. Nu pune parole sau date secrete în Base64 crezând că le protejezi.

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.