...
Eroare JavaScript · Tipuri greșite: funcții, tablouri, iterabile

TypeError: Number.prototype.toFixed requires that 'this' be a Number

Pe scurt

O metodă de număr (toFixed, toString, toLocaleString) a fost apelată pe o valoare care nu e număr, de obicei un text din formular trecut prin Number.prototype.toFixed.call(...) sau o metodă scoasă din obiect. Convertește întâi valoarea: Number(valoare).toFixed(2).

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

Ce înseamnă

Metodele din Number.prototype lucrează pe this, adică pe numărul pe care sunt apelate. Când scrii (12.5).toFixed(2), this e 12.5. Dacă metoda ajunge să fie apelată cu alt this (un text, undefined, un obiect), motorul refuză: Number.prototype.toFixed requires that 'this' be a Number. Același tip de mesaj există pentru String.prototype.toString, Boolean.prototype.toString, BigInt.prototype.toString, Symbol.prototype.toString și Function.prototype.toString.

Se întâmplă în două situații:

  • apelezi metoda explicit, cu .call sau .apply, pe o valoare care nu e de tipul potrivit, de exemplu un text din input.value;
  • scoți metoda din context și o apelezi separat (const f = pret.toFixed; f(2)), deci this devine undefined.

Dacă scrii direct "12.5".toFixed(2) primești altă eroare (toFixed is not a function), pentru că textele nu au metoda.

De ce apare: cauzele frecvente

1Text din formular trecut prin .call

Greșit
JavaScript
const valori = ["12.5", "3"];
valori.map((v) => Number.prototype.toFixed.call(v, 2));
Corect
JavaScript
const valori = ["12.5", "3"];
valori.map((v) => Number(v).toFixed(2));

Number(v) transformă textul în număr, iar toFixed e apelat pe un număr real.

2Metodă scoasă din context

Greșit
JavaScript
const pret = 19.99;
const formateaza = pret.toFixed;
formateaza(1);
Corect
JavaScript
const pret = 19.99;
const formateaza = (zecimale) => pret.toFixed(zecimale);
formateaza(1);

Scoasă din obiect, metoda pierde this. Arrow function o apelează mereu pe pret.

3Metodă de număr dată direct ca callback

Greșit
JavaScript
[1.5, 2.25].map(Number.prototype.toFixed);
Corect
JavaScript
[1.5, 2.25].map((n) => n.toFixed(1));

map apelează callback-ul fără this, deci metoda primește undefined în loc de număr.

Repară tu

Repară eroarea, direct în pagină

Prețurile vin dintr-un formular ca texte, iar funcția de formatare le dă direct metodei toFixed, așa că apare TypeError: Number.prototype.toFixed requires that 'this' be a Number. Repară funcția formateaza ca programul să afișeze 12.50 lei, 3.00 lei.

Codul care dă eroarea
JavaScript
const preturi = ["12.5", "3"];

function formateaza(text) {
  return `${Number.prototype.toFixed.call(text, 2)} lei`;
}

console.log(preturi.map(formateaza).join(", "));
După reparație, programul afișează
12.50 lei, 3.00 lei
Indiciu

Transformă textul în număr cu Number(...) și apelează toFixed pe rezultat.

Alte forme ale mesajului

  • TypeError: Number.prototype.toString requires that 'this' be a Number
  • TypeError: String.prototype.toString requires that 'this' be a String
  • TypeError: Function.prototype.toString requires that 'this' be a Function
  • TypeError: BigInt.prototype.toString requires that 'this' be a BigInt
  • TypeError: toFixed method called on incompatible String

Cum o eviți pe viitor

  • Convertește explicit datele din formulare și din API: Number(text) sau parseFloat(text), apoi verifică Number.isNaN.
  • Nu scoate metode din obiecte fără să le legi; folosește arrow functions ca callback.
  • Folosește Intl.NumberFormat pentru formatare, care primește valoarea ca argument, nu ca this.
  • Evită .call pe metodele tipurilor de bază, în afară de cazurile în care chiar ai nevoie.

Întrebări frecvente

De ce "12.5".toFixed(2) nu dă aceeași eroare?

Pentru că textele nu au metoda toFixed, deci primești toFixed is not a function. Eroarea din pagină apare doar când metoda ajunge totuși să fie apelată pe altceva, de exemplu prin .call.

Number("12,5") funcționează?

Nu, întoarce NaN, iar NaN.toFixed(2) dă textul "NaN". Înlocuiește virgula cu punct înainte de conversie.

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.