Math.min()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

Specification
ECMAScript® 2026 Language Specification # sec-math.min

Browser-Kompatibilität

Siehe auch

Math.max()