Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Math.min: nejmenší hodnota

Math.min převede každý argument na Number a vrátí nejmenší z výsledných hodnot.

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

Syntaxe

Math.min(...args)

Math.min(...args) nejprve v pořadí použije ToNumber na všechny argumenty a pak zvolí nejmenší výsledek. Bez argumentů vrátí Infinity, neutrální prvek hledání minima. Je-li některá převedená hodnota NaN, výsledkem je NaN; všechny převody však proběhnou ještě před tímto testem.

Číselné řetězce a jiné převoditelné hodnoty přijímá, kdežto Symbol či BigInt vyvolá TypeError. Objekty mohou spustit valueOf nebo toString a chyba převodu volání ukončí. Z obou nul se -0 považuje za menší než +0; -Infinity je menší než každý konečný Number.

Funkce existuje od ECMAScript 1 a není konstruktor. Pro malé pole je praktické Math.min(...values). Velkou kolekci nerozbalujte, protože limit argumentů závisí na enginu; použijte cyklus či reduce a určete chování pro prázdný vstup a NaN.

Pří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ýsledek

-4
Infinity true
true
2
true
true a,b

Math.min → -4 and ordered coercion a,b

Zdroje