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 vorhanden sind.

Probieren Sie es aus

Syntax

js
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 gegebenen Zahlen. Gibt NaN zurück, wenn einer der Parameter NaN ist oder in NaN umgewandelt wird. Gibt Infinity zurück, wenn keine Parameter bereitgestellt werden.

Beschreibung

Da min() eine statische Methode von Math ist, verwenden Sie sie immer als Math.min() und nicht als Methode eines von Ihnen erstellten Math-Objekts (Math ist kein Konstruktor).

Math.min.length ist 2, was schwach signalisiert, dass es entworfen wurde, um mindestens zwei Parameter zu verarbeiten.

Beispiele

Verwendung von Math.min()

Dies findet das Minimum von x und y und weist es z zu:

js
const x = 10;
const y = -20;
const z = Math.min(x, y); // -20

Clipping eines Wertes mit Math.min()

Math.min() wird häufig verwendet, um einen Wert zu begrenzen, sodass er immer kleiner oder gleich einer Grenze ist. Zum Beispiel kann dies

js
let x = f(foo);

if (x > boundary) {
  x = boundary;
}

so geschrieben werden

js
const x = Math.min(f(foo), boundary);

Math.max() kann in ähnlicher Weise verwendet werden, um einen Wert am anderen Ende zu begrenzen.

Spezifikationen

Specification
ECMAScript Language Specification
# sec-math.min

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch