...
Eroare JavaScript · Numere, BigInt și formatare (Intl)

RangeError: toString() radix argument must be between 2 and 36

Pe scurt

Ai apelat numar.toString(baza) cu o bază în afara intervalului 2-36, de exemplu toString(64) (crezând că face base64), toString(1) sau toString(0). Bazele valide sunt de la 2 (binar) la 36 (cifre + litere). Pentru base64 pe text folosește btoa sau Buffer, nu toString.

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

Ce înseamnă

Number.prototype.toString(radix) (și BigInt.prototype.toString) scrie numărul într-o bază de numerație: (255).toString(2) dă "11111111", (255).toString(16) dă "ff". Baza poate fi de la 2 la 36: 10 cifre plus 26 de litere ale alfabetului latin. Orice altă valoare aruncă această RangeError.

Situații reale:

  • id.toString(64) din ideea că așa obții base64. Base64 e o codificare de octeți, nu o bază de numerație suportată de toString;
  • confuzia cu toFixed: pret.toString(2) nu dă două zecimale, ci scrie numărul în binar (fără eroare, dar greșit), iar toString(0) dă eroarea;
  • o bază venită dintr-o variabilă calculată greșit sau dintr-o setare.

Pentru ID-uri scurte, baza 36 e varianta standard: (123456789).toString(36) dă "21i3v9", iar parseInt("21i3v9", 36) îl transformă înapoi.

De ce apare: cauzele frecvente

1Baza 64 pentru „base64”

Greșit
JavaScript
const cod = id.toString(64);
Corect
JavaScript
const cod = id.toString(36);

36 e baza maximă suportată și dă tot un cod scurt, din cifre și litere.

2toString confundat cu toFixed

Greșit
JavaScript
const text = pret.toString(0);
Corect
JavaScript
const text = pret.toFixed(0);

toFixed(n) stabilește zecimalele; toString(n) stabilește baza.

3Bază dintr-o variabilă nevalidată

Greșit
JavaScript
const baza = Number(setari.baza); // NaN sau 100
n.toString(baza);
Corect
JavaScript
const baza = Number(setari.baza);
const ok = Number.isInteger(baza) && baza >= 2 && baza <= 36;
n.toString(ok ? baza : 10);

Verifici intervalul înainte de apel.

Repară tu

Repară eroarea, direct în pagină

Funcția codScurt transformă ID-ul unei comenzi într-un cod scurt, dar programul se oprește cu RangeError: toString() radix argument must be between 2 and 36. Folosește cea mai mare bază acceptată de toString, ca programul să afișeze Cod: CMD-21I3V9.

Codul care dă eroarea
JavaScript
function codScurt(id) {
  return "CMD-" + id.toString(64).toUpperCase();
}

console.log(`Cod: ${codScurt(123456789)}`);
După reparație, programul afișează
Cod: CMD-21I3V9
Indiciu

Baza maximă e 36 (10 cifre + 26 de litere).

Alte forme ale mesajului

  • RangeError: radix must be an integer at least 2 and no greater than 36
  • RangeError: toString() radix must be between 2 and 36

Cum o eviți pe viitor

  • Ține minte intervalul: bazele 2, 8, 10, 16 și 36 sunt cele folosite în practică.
  • Pentru zecimale folosește toFixed, pentru formatare Intl.NumberFormat.
  • Pentru base64 pe text folosește btoa / atob (cu grijă la diacritice) sau Buffer.from(text).toString("base64") în Node.
  • Validează bazele venite din exterior.

Întrebări frecvente

De ce parseInt("z", 37) nu dă eroare?

parseInt nu aruncă pentru o bază invalidă; întoarce NaN. Doar toString aruncă RangeError.

Ce face toString(2) pe un număr cu zecimale?

Scrie și partea fracționară în binar: (0.5).toString(2) dă "0.1". E util pentru a înțelege erorile de rotunjire, nu pentru afișarea prețurilor.

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.