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 übergebenen Zahlen zurück oder Infinity, falls keine Parameter übergeben 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 array1 = [2, 3, 1];

console.log(Math.min(...array1));
// Expected output: 1

Syntax

js
Math.min()
Math.min(value1)
Math.min(value1, value2)
Math.min(value1, value2, /* …, */ valueN)

Parameter

value1, …, valueN

Null oder mehr Zahlen, von denen der geringste 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 sie immer als Math.min() verwendet und nicht als Methode eines durch Sie erstellten Math Objekts (Math ist kein Konstruktor).

Math.min.length ist 2, was schwach signalisiert, dass sie darauf ausgelegt ist, mit mindestens zwei Parametern zu arbeiten.

Beispiele

Verwendung von Math.min()

Hier wird das Minimum von x und y gefunden und z zugewiesen:

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

Begrenzen 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® 2025 Language Specification
# sec-math.min

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
min

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch