CKTIS / JavaScript
Math.min: najmanjša vrednost
Math.min pretvori vsak argument v Number in vrne najmanjšo od nastalih vrednosti.
Različica: ECMAScript 1 onward; example target: Node.js 24.22.2
Sintaksa
Math.min(...args)Math.min(...args) najprej po vrsti uporabi ToNumber za vse argumente, nato izbere najmanjši rezultat. Brez argumentov vrne Infinity, nevtralni element pri iskanju minimuma. Če je katera pretvorjena vrednost NaN, je rezultat NaN; vse pretvorbe se vendarle izvedejo pred tem preizkusom.
Številske nize in druge pretvorljive vrednosti sprejme, Symbol ali BigInt pa sproži TypeError. Objekti lahko izvedejo valueOf ali toString, napaka pretvorbe pa klic prekine. Med ničlama velja -0 za manjšo od +0; -Infinity je manjša od vsakega končnega Number.
Funkcija obstaja od ECMAScript 1 in ni konstruktor. Za majhno polje je praktično Math.min(...values). Zelo velike zbirke ne razširjajte, ker je omejitev argumentov odvisna od pogona; uporabite zanko ali reduce in določite obravnavo praznega vhoda ter NaN.
Primeri
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(","));Rezultat
-4 Infinity true true 2 true true a,b
Math.min → -4 and ordered coercion a,b