Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri