Math.max w JavaScript - Pełny Przewodnik i Pułapki

Najczęściej zaczynam od Math.max(), gdy trzeba szybko znaleźć największą liczbę z kilku wartości, ale w realnym kodzie równie ważne jest to, co dzieje się na pustej liście i przy danych z formularza. W JavaScript ta funkcja jest prosta, ale ma kilka zachowań, które dobrze znać, zanim wrzuci się ją do projektu. Pokażę tu najkrótszy zapis, wersję dla tablic, własną funkcję pomocniczą oraz miejsca, w których lepiej wybrać reduce() albo pętlę.

Jak działa Math.max() i dlaczego bez argumentów zwraca -Infinity

Math.max() to statyczna metoda obiektu Math, więc wywołujesz ją bez tworzenia żadnej instancji. Porównuje przekazane wartości po konwersji do typu liczbowego i zwraca największą z nich. Najważniejsza reguła jest prosta: gdy nie przekażesz żadnego argumentu, funkcja nie zgłasza błędu, tylko zwraca -Infinity, bo to naturalny punkt startowy dla szukania maksimum.

W praktyce warto pamiętać też o konwersji. Numeryczne teksty, takie jak "12", mogą zostać potraktowane jak liczby, ale tekst typu "12px" już psuje wynik. To samo dotyczy wartości, których JavaScript nie potrafi sensownie zamienić na liczbę. Dla mnie to ważne rozróżnienie, bo pozwala od razu zdecydować, czy funkcja ma działać „luźno”, czy ma być rygorystyczna.

Jest jeszcze jedna granica, o której nie warto zapominać: Math pracuje z Number, a nie z BigInt. Jeśli w projekcie pojawiają się bardzo duże liczby całkowite, trzeba je obsłużyć osobno. Gdy ten model jest jasny, najprościej przejść do pracy z tablicą, bo tam taka funkcja pojawia się najczęściej.

Najprostszy sposób na maksimum z tablicy

W kodzie produkcyjnym najczęściej nie przekazujesz liczb jedna po drugiej, tylko trzymasz je w tablicy. Tu kluczowy jest spread (...), który rozpakowuje elementy tablicy na osobne argumenty funkcji. To właśnie dlatego zapis Math.max(...values) działa, a Math.max(values) zwraca NaN.

const values = [14, 7, 23, 9];

Math.max(values);     // NaN
Math.max(...values);  // 23

Ten wariant jest krótki i bardzo czytelny, więc ja też używam go często, zwłaszcza gdy tablica jest niewielka i wiem, że zawiera liczby. Jeśli tablica jest pusta, wynik nadal będzie zgodny z zachowaniem funkcji, czyli -Infinity. To bywa wygodne, ale tylko wtedy, gdy taki rezultat ma sens w Twojej logice. W interfejsie użytkownika czasem lepiej zamienić go na null albo komunikat „brak danych”.

Starszy zapis z apply() nadal działa, ale dziś spread jest zwykle prostszy do odczytania. Jeśli masz już tablicę i chcesz po prostu policzyć maksimum, to najkrótsza wersja jest zwykle najlepsza. Gdy jednak ten sam fragment pojawia się w kilku miejscach aplikacji, warto zamknąć go we własnej funkcji.

Własna funkcja dla zero lub więcej liczb

Ja zwykle piszę mały helper wtedy, gdy logika maksimum pojawia się częściej niż raz. Dzięki temu nie powtarzam tego samego wywołania i mogę łatwiej dodać walidację albo zmienić sposób obsługi pustych danych. Najprostsza wersja jest naprawdę krótka:

Gdy chcesz tylko prostą funkcję

function maxValue(...numbers) {
  return Math.max(...numbers);
}

Ten wariant działa także dla wywołania bez argumentów, bo Math.max() ma wbudowaną obsługę pustego zestawu danych. Jeśli jednak wolisz, żeby zachowanie było jawne, możesz dodać prosty warunek:

function maxValue(...numbers) {
  if (numbers.length === 0) {
    return -Infinity;
  }

  return Math.max(...numbers);
}

Przeczytaj również: Pętla while w JavaScript - Jak używać i unikać błędów?

Gdy wejście przychodzi z formularza

Przy danych tekstowych nie ufam temu, co przyszło z formularza albo z niepewnego źródła. Najpierw zamieniam wartości na liczby i sprawdzam, czy nie wpadło coś niepoprawnego:

function maxFromText(values) {
  const numbers = values.map(Number);

  if (numbers.some(Number.isNaN)) {
    return NaN;
  }

  return numbers.length === 0 ? -Infinity : Math.max(...numbers);
}

Taki podział robi dużą różnicę: jedna część kodu odpowiada za obliczenie maksimum, druga za kontrolę jakości danych. W praktyce to dużo bezpieczniejsze niż liczenie „na ślepo”, bo problem wychodzi od razu, a nie dopiero po cichym błędzie w wynikach.

Najczęstsze pułapki przy danych wejściowych

Najwięcej problemów widzę nie w samym wywołaniu funkcji, tylko w tym, co do niej trafia. JavaScript lubi konwersje, ale nie zawsze są one zgodne z intuicją. Jeśli chcesz uniknąć niespodzianek, sprawdź te przypadki zanim uznasz, że funkcja działa źle.

W praktyce największe zaskoczenie budzą dwa miejsca: pusta lista oraz tekst udający liczbę. Dlatego ja zazwyczaj oddzielam walidację od samego obliczenia. Dzięki temu kod jest czytelniejszy, a błąd łatwiej zlokalizować. Jeśli dane są niepewne, nie próbuję zgadywać wyniku, tylko wymuszam poprawny format wejścia.

Jeśli lista może zawierać BigInt, nie wciskam jej na siłę do Math.max(). To inny typ liczbowy i wymaga osobnego podejścia. Ten sam problem pojawia się też przy bardzo dużych tablicach, bo wtedy wygoda spreadu zaczyna ustępować miejsca kontroli nad wykonaniem.

Kiedy lepszy będzie reduce() albo zwykła pętla

Ja zwykle dzielę to na trzy scenariusze: mała tablica i czytelny kod, większa tablica i bezpieczeństwo albo miejsce, w którym i tak już iteruję po danych. Właśnie wtedy dobrze widać, że Math.max(...values) nie jest jedyną sensowną odpowiedzią.

function maxFromArray(values) {
  let max = -Infinity;

  for (const value of values) {
    if (value > max) {
      max = value;
    }
  }

  return max;
}

Ten wariant lubię najbardziej, gdy kod ma być oczywisty dla kolejnej osoby z zespołu. Nie ma tu sztuczek, nie ma limitu argumentów, nie ma ukrytego zachowania. Jest prosta pętla, która działa dla zera, jednego i wielu elementów. W miejscach, gdzie liczy się stabilność i łatwe debugowanie, to bardzo rozsądny wybór.

Najrozsądniejszy domyślny wybór w projekcie

Jeśli dane są czyste i masz do policzenia kilka liczb, Math.max() jest najlepszym pierwszym wyborem. Gdy pracujesz na tablicy, użyj spreadu albo reduce(), a przy wejściu z formularza zawsze waliduj wartości przed obliczeniem. Najważniejsze nie jest to, żeby kod był najkrótszy, ale żeby wynik był przewidywalny także wtedy, gdy lista okaże się pusta albo ktoś przekaże tekst zamiast liczby.

Ja w praktyce stosuję prostą zasadę: krótkie dane i pewny typ to Math.max(...), większa tablica lub krytyczna ścieżka to pętla albo reduce(), a niepewne źródło oznacza walidację przed obliczeniem. Taki układ wystarcza, żeby funkcja szukająca maksimum działała stabilnie i bez późniejszych poprawek.