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

TypeError: The comparison function must be either a function or undefined

Pe scurt

Ai dat metodei `sort` (sau `toSorted`) ceva ce nu e funcție, de exemplu `sort("asc")` sau `sort(true)`. Argumentul lui `sort` e o funcție de comparare: `lista.sort((a, b) => a - b)` pentru crescător, `(a, b) => b - a` pentru descrescător.

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

Ce înseamnă

Array.prototype.sort primește opțional o funcție de comparare (a, b) => număr: negativ dacă a vine înainte, pozitiv dacă vine după, 0 dacă sunt egale. Dacă argumentul există, dar nu e funcție (un text, un boolean, un obiect, rezultatul unei funcții apelate prea devreme), V8 aruncă The comparison function must be either a function or undefined, adesea urmat de valoarea primită (: asc).

Greșeala vine des din alte limbaje sau biblioteci (sort("asc"), sort(reverse=True) din Python, orderBy din lodash) sau din apelarea funcției în loc de transmiterea ei: sort(comparaPret()) în loc de sort(comparaPret).

Atenție și la cealaltă capcană: sort() fără argument compară elementele ca texte, deci [10, 9, 1].sort() dă [1, 10, 9].

De ce apare: cauzele frecvente

1Direcția scrisă ca text

Greșit
JavaScript
const preturi = [30, 5, 12];
preturi.sort("desc");
Corect
JavaScript
const preturi = [30, 5, 12];
preturi.sort((a, b) => b - a);

sort nu înțelege texte ca „desc”. Ordinea o dă semnul rezultatului funcției.

2Funcția apelată în loc să fie transmisă

Greșit
JavaScript
function dupaPret(a, b) { return a.pret - b.pret; }
produse.sort(dupaPret());
Corect
JavaScript
function dupaPret(a, b) { return a.pret - b.pret; }
produse.sort(dupaPret);

dupaPret() rulează imediat și dă NaN. sort are nevoie de funcția însăși, fără paranteze.

3Obiect de opțiuni ca în alte biblioteci

Greșit
JavaScript
nume.sort({ ordine: "alfabetic" });
Corect
JavaScript
nume.sort((a, b) => a.localeCompare(b, "ro"));

Pentru texte cu diacritice, localeCompare cu limba română dă ordinea corectă.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos vrea să afișeze prețurile de la cel mai mare la cel mai mic, dar se oprește cu TypeError: The comparison function must be either a function or undefined: desc. Repară apelul lui sort ca programul să afișeze Prețuri: 240, 88, 45, 19.

Codul care dă eroarea
JavaScript
const preturi = [45, 19, 240, 88];

preturi.sort("desc");

console.log(`Prețuri: ${preturi.join(", ")}`);
După reparație, programul afișează
Prețuri: 240, 88, 45, 19
Indiciu

Pentru ordine descrescătoare, funcția de comparare returnează b - a.

Alte forme ale mesajului

  • TypeError: The comparison function must be either a function or undefined: asc
  • TypeError: invalid Array.prototype.sort argument
  • TypeError: The comparison function must be either a function or undefined: NaN

Cum o eviți pe viitor

  • Memorează cele două forme: (a, b) => a - b (crescător) și (a, b) => b - a (descrescător) pentru numere.
  • Pentru texte folosește a.localeCompare(b, "ro").
  • Transmite funcția fără paranteze: sort(dupaPret).
  • Dacă nu vrei să modifici tabloul original, folosește toSorted cu aceeași funcție.

Întrebări frecvente

De ce [10, 9, 1].sort() dă [1, 10, 9]?

Fără funcție de comparare, sort transformă elementele în texte și le compară alfabetic: „1” < „10” < „9”. Pentru numere dă întotdeauna o funcție: sort((a, b) => a - b).

Pot scrie funcția să returneze true/false?

Nu e corect: sort așteaptă un număr negativ, pozitiv sau 0. Cu boolean, rezultatul poate ieși greșit în unele motoare. Folosește scăderea sau localeCompare.

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.