База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Math.min: най-малка стойност

Math.min преобразува всеки аргумент до Number и връща най-малката от получените стойности.

Версия: ECMAScript 1 onward; example target: Node.js 24.22.2

Синтаксис

Math.min(...args)

Math.min(...args) първо прилага ToNumber към всички аргументи по ред, след което избира най-малкия резултат. Без аргументи връща Infinity, неутралния елемент при търсене на минимум. Ако преобразуван аргумент е NaN, резултатът е NaN; всички преобразувания все пак се извършват преди тази проверка.

Числови низове и други преобразуеми стойности се приемат, а Symbol или BigInt хвърля TypeError. Обектите може да изпълнят valueOf или toString, а грешка при преобразуване прекратява извикването. Между двете нули -0 се смята за по-малка от +0; -Infinity е по-малка от всеки краен Number.

Функцията съществува от ECMAScript 1 и не е конструктор. За малък масив е практично Math.min(...values). Не разгръщайте огромна колекция, защото лимитът на аргументите зависи от енджина; използвайте цикъл или reduce и задайте поведението за празен вход и NaN.

Примери

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(","));

Резултат

-4
Infinity true
true
2
true
true a,b

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

Източници