CKTIS / JavaScript
Math.min: najmenšia hodnota
Math.min prevedie každý argument na Number a vráti najmenšiu z výsledných hodnôt.
Verzia: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntax
Math.min(...args)Math.min(...args) najprv v poradí použije ToNumber na všetky argumenty a potom zvolí najmenší výsledok. Bez argumentov vráti Infinity, neutrálny prvok hľadania minima. Ak je niektorá prevedená hodnota NaN, výsledkom je NaN; všetky prevody však prebehnú ešte pred týmto testom.
Číselné reťazce a iné prevoditeľné hodnoty prijíma, kým Symbol či BigInt vyvolá TypeError. Objekty môžu spustiť valueOf alebo toString a chyba prevodu volanie ukončí. Z oboch núl sa -0 považuje za menšiu než +0; -Infinity je menšia než každý konečný Number.
Funkcia existuje od ECMAScript 1 a nie je konštruktor. Pre malé pole je praktické Math.min(...values). Veľkú kolekciu nerozbaľujte, lebo limit argumentov závisí od enginu; použite cyklus či reduce a určte správanie pre prázdny vstup a NaN.
Príklady
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(","));Výsledok
-4 Infinity true true 2 true true a,b
Math.min → -4 and ordered coercion a,b