CKTIS / JavaScript
Math.min: najmniejsza wartość
Math.min konwertuje wszystkie argumenty do Number i zwraca najmniejszą z otrzymanych wartości.
Wersja: ECMAScript 1 onward; example target: Node.js 24.22.2
Składnia
Math.min(...args)Math.min(...args) najpierw wykonuje ToNumber dla każdego argumentu w kolejności, a potem wybiera najmniejszy wynik. Bez argumentów zwraca Infinity, neutralny element szukania minimum. Jeśli dowolny przekonwertowany argument jest NaN, wynikiem jest NaN; wszystkie konwersje następują 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 mniejsze od +0; -Infinity wygrywa jako minimum z każdą skończoną liczbą.
Funkcja istnieje od ECMAScript 1 i nie jest konstruktorem. Dla małej tablicy praktyczne jest Math.min(...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.min(...scores));
console.log(Math.min(), Number.isNaN(Math.min(3, undefined)));
console.log(Object.is(Math.min(-0, +0), -0));
console.log(Math.min("6", 2));
try { Math.min(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.min(a, b)), seen.join(","));Wynik
-4 Infinity true true 2 true true a,b
Math.min → -4 and ordered coercion a,b