Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Math.max: największa wartość

Math.max konwertuje wszystkie argumenty do Number i zwraca największą z otrzymanych wartości.

Wersja: ECMAScript 1 onward; example target: Node.js 24.22.2

Składnia

Math.max(...args)

Math.max(...args) najpierw wykonuje ToNumber dla każdego argumentu w kolejności, a potem wybiera największy wynik. Bez argumentów zwraca -Infinity, więc ta wartość jest elementem neutralnym dla szukania maksimum. Jeśli dowolny przekonwertowany argument jest NaN, wynikiem jest NaN; wszystkie konwersje zachodzą jednak przed tym testem.

Łańcuchy liczbowe i inne wartości konwertowalne są akceptowane, natomiast Symbol i BigInt powodują TypeError. Obiekty mogą uruchomić valueOf lub toString, a błąd konwersji przerywa wywołanie. Przy remisie zer +0 jest uznawane za większe od -0; Infinity wygrywa z każdą skończoną liczbą.

Funkcja istnieje od ECMAScript 1 i nie jest konstruktorem. Dla małej tablicy praktyczne jest Math.max(...values). Nie rozpraszaj bardzo dużych kolekcji, ponieważ limit argumentów zależy od silnika; zastosuj pętlę lub reduce, świadomie ustalając zachowanie dla pustego wejścia i NaN.

Przykłady

const scores = [-4, 12, 7];
console.log(Math.max(...scores));
console.log(Math.max(), Number.isNaN(Math.max(3, undefined)));
console.log(Object.is(Math.max(-0, +0), +0));
console.log(Math.max("6", 2));
try { Math.max(1n, 2); } catch (error) { console.log(error instanceof TypeError); }
const seen = [];
const a = { valueOf() { seen.push("a"); return NaN; } };
const b = { valueOf() { seen.push("b"); return 4; } };
console.log(Number.isNaN(Math.max(a, b)), seen.join(","));

Wynik

12
-Infinity true
true
6
true
true a,b

Math.max → 12 and ordered coercion a,b

Źródła