Math.min() — Methode · JavaScript-Referenz

Signatur

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

Beschreibung

Die statische Methode Math.min() gibt die kleinste der als Eingabeparameter übergebenen Zahlen zurück oder Infinity, wenn keine Parameter übergeben werden.

Da min() eine statische Methode von Math ist, verwendest du sie immer als Math.min() und nicht als Methode eines von dir erstellten Math-Objekts (Math ist kein Konstruktor).

Math.min.length ist 2, was schwach signalisiert, dass sie für mindestens zwei Parameter ausgelegt ist.

Parameter

Name	Typ	Default	Beschreibung
$value1, …, valueN	number	—	Null oder mehr Zahlen, aus denen der kleinste Wert ausgewählt und zurückgegeben wird.

Rückgabewert

Typ

number

Beschreibung

Die kleinste der übergebenen Zahlen. Gibt NaN zurück, wenn einer der Parameter NaN ist oder in NaN umgewandelt wird. Gibt Infinity zurück, wenn keine Parameter übergeben werden.

Beispiele

Math.min() verwenden

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

Einen Wert mit Math.min() begrenzen

let x = f(foo);

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

Kompakte Schreibweise mit Math.min()

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

// Wichtig · Fallstricke

Math.min() wird häufig verwendet, um einen Wert so zu begrenzen, dass er stets kleiner oder gleich einer Grenze ist. Math.max() kann auf ähnliche Weise verwendet werden, um einen Wert am anderen Ende zu begrenzen.

Siehe auch

Math.max()