Math.min()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die statische Methode Math.min() gibt die kleinste der als Eingabeparameter gegebenen Zahlen zurück oder Infinity, wenn keine Parameter angegeben werden.
Probieren Sie es aus
console.log(Math.min(2, 3, 1));
// Expected output: 1
console.log(Math.min(-2, -3, -1));
// Expected output: -3
const array = [2, 3, 1];
console.log(Math.min(...array));
// Expected output: 1
Syntax
Math.min()
Math.min(value1)
Math.min(value1, value2)
Math.min(value1, value2, /* …, */ valueN)
Parameter
value1, …,valueN-
Null oder mehr Zahlen, unter denen der niedrigste Wert ausgewählt und zurückgegeben wird.
Rückgabewert
Die kleinste der angegebenen Zahlen. Gibt NaN zurück, wenn einer der Parameter NaN ist oder in NaN umgewandelt wird. Gibt Infinity zurück, wenn keine Parameter angegeben werden.
Beschreibung
Da min() eine statische Methode von Math ist, wird es immer als Math.min() verwendet und nicht als Methode eines erstellten Math-Objekts (Math ist kein Konstruktor).
Math.min.length ist 2, was schwach darauf hinweist, dass es dafür ausgelegt ist, mindestens zwei Parameter zu verarbeiten.
Beispiele
Verwendung von Math.min()
Dies findet das Minimum von x und y und weist es z zu:
const x = 10;
const y = -20;
const z = Math.min(x, y); // -20
Clipping eines Wertes mit Math.min()
Math.min() wird oft verwendet, um einen Wert zu beschränken, so dass er immer kleiner oder gleich einer Grenze ist. Zum Beispiel kann dies
let x = f(foo);
if (x > boundary) {
x = boundary;
}
so geschrieben werden
const x = Math.min(f(foo), boundary);
Math.max() kann auf ähnliche Weise verwendet werden, um einen Wert am anderen Ende zu beschränken.
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-math.min |