WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen