CKTIS / JavaScript
Math.min: kleinster Wert
Math.min wandelt jedes Argument in Number um und liefert den kleinsten entstandenen Wert.
Version: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntax
Math.min(...args)Math.min(...args) wendet zunächst der Reihe nach ToNumber auf alle Argumente an und wählt danach den kleinsten Wert. Ohne Argumente liefert die Funktion Infinity, das neutrale Element der Minimumsuche. Ist ein umgewandeltes Argument NaN, ist das Ergebnis NaN; alle Umwandlungen erfolgen jedoch vor diesem Test.
Numerische Zeichenketten und andere umwandelbare Werte werden akzeptiert, Symbol oder BigInt löst TypeError aus. Objekte können valueOf oder toString ausführen; ein Umwandlungsfehler bricht den Aufruf ab. Zwischen den beiden Nullwerten gilt -0 als kleiner als +0; -Infinity ist kleiner als jede endliche Number.
Die Funktion existiert seit ECMAScript 1 und ist kein Konstruktor. Für kleine Arrays ist Math.min(...values) praktisch. Sehr große Sammlungen nicht verteilen, da Argumentgrenzen engineabhängig sind; Schleife oder reduce verwenden und leere Eingabe sowie NaN bewusst behandeln.
Beispiele
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(","));Ergebnis
-4 Infinity true true 2 true true a,b
Math.min → -4 and ordered coercion a,b