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

RangeError: maximumFractionDigits value is out of range.

Pe scurt

La Intl.NumberFormat sau toLocaleString, maximumFractionDigits e invalid: mai mic decât minimumFractionDigits (min 2, max 1), peste 100 sau nu e număr. Pune maximumFractionDigits mai mare sau egal cu minimumFractionDigits; pentru exact două zecimale, setează-le pe amândouă la 2.

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

Ce înseamnă

Intl.NumberFormat (și numar.toLocaleString(locale, optiuni)) controlează zecimalele prin două opțiuni:

  • minimumFractionDigits: câte zecimale se afișează cel puțin (completează cu zerouri);
  • maximumFractionDigits: câte zecimale se afișează cel mult (rotunjește).

Amândouă trebuie să fie numere întregi între 0 și 100, iar minimul nu poate depăși maximul. Dacă maximumFractionDigits e mai mic decât minimul, e peste 100 sau nu se poate transforma într-un număr ("doua"), motorul aruncă această RangeError. Pentru minim invalid, mesajul e minimumFractionDigits value is out of range.

Situația cea mai frecventă: vrei „exact două zecimale”, pui minimumFractionDigits: 2 și lași un maximumFractionDigits: 1 rămas din altă variantă, sau le inversezi. În versiuni mai vechi de Chrome, eroarea apărea și la style: "currency" cu maximumFractionDigits: 0, pentru că minimul implicit al monedei era 2; acolo setează și minimumFractionDigits: 0.

De ce apare: cauzele frecvente

1Minim mai mare decât maxim

Greșit
JavaScript
n.toLocaleString("ro-RO", { minimumFractionDigits: 2, maximumFractionDigits: 1 });
Corect
JavaScript
n.toLocaleString("ro-RO", { minimumFractionDigits: 2, maximumFractionDigits: 2 });

Pentru un număr fix de zecimale, minimul și maximul sunt egale.

2Monedă fără zecimale în browsere mai vechi

Greșit
JavaScript
new Intl.NumberFormat("ro-RO", {
  style: "currency", currency: "RON", maximumFractionDigits: 0,
});
Corect
JavaScript
new Intl.NumberFormat("ro-RO", {
  style: "currency", currency: "RON",
  minimumFractionDigits: 0, maximumFractionDigits: 0,
});

Moneda are implicit minim 2 zecimale; setând și minimul la 0, combinația e validă peste tot.

3Valoare care nu e număr

Greșit
JavaScript
const zecimale = setari.zecimale; // "doua"
new Intl.NumberFormat("ro-RO", { maximumFractionDigits: zecimale });
Corect
JavaScript
const zecimale = Number.parseInt(setari.zecimale, 10);
new Intl.NumberFormat("ro-RO", { maximumFractionDigits: Number.isNaN(zecimale) ? 2 : zecimale });

Valoarea trebuie să fie un întreg valid între 0 și 100.

Repară tu

Repară eroarea, direct în pagină

Programul afișează totalul unui coș cu exact două zecimale, după regulile românești, dar se oprește cu RangeError: maximumFractionDigits value is out of range. Repară opțiunile formatorului ca programul să afișeze Total: 1.234,50 lei.

Codul care dă eroarea
JavaScript
const format = new Intl.NumberFormat("ro-RO", {
  minimumFractionDigits: 2,
  maximumFractionDigits: 1,
});

console.log(`Total: ${format.format(1234.5)} lei`);
După reparație, programul afișează
Total: 1.234,50 lei
Indiciu

Pentru exact două zecimale, minimul și maximul trebuie să fie egale.

Alte forme ale mesajului

  • RangeError: minimumFractionDigits value is out of range.
  • RangeError: maximumSignificantDigits value is out of range.

Cum o eviți pe viitor

  • Când vrei un număr fix de zecimale, setează minimumFractionDigits și maximumFractionDigits la aceeași valoare.
  • Creează formatorii o dată, într-un singur loc (formatLei, formatProcent).
  • Validează zecimalele venite din setări sau din formular.
  • Testează formatorul în browserele țintă, inclusiv versiunile mai vechi, dacă folosești monede.

Întrebări frecvente

De ce toFixed(2) nu are problema asta?

toFixed are un singur parametru, deci nu există conflict între minim și maxim. Dar nu adaugă separatorul de mii și folosește mereu punctul zecimal; Intl.NumberFormat formatează după regulile limbii.

Ce înseamnă maximumSignificantDigits?

Limitează numărul total de cifre semnificative, nu doar zecimalele. Are propriul interval (1-21) și aceeași regulă: minimul nu poate depăși maximul.

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.