Die Math.min() Funktion gibt den Wert der kleinsten übergebenen Zahl zurück oder NaN, wenn ein Parameter keine Zahl ist und auch nicht in eine Zahl konvertiert werden kann.

Syntax

Math.min([value1[, value2[, ...]]])

Parameter

value1, value2, ...
Zahlen.

Rückgabewert

Die kleinste der übergebenen Zahlen. Wenn nur ein Parameter nicht zu einer Zahl konvertiert werden kann, wird NaN zurückgegeben.

Beschreibung

Da min() eine statische Eigenschaft von Math ist, muss immer Math.min() genutzt werden, ohne dass ein Math-Objekt erstellt wird (Math ist kein Konstruktor).

Ohne Übergabeparameter wird Infinity zurückgegeben.

Wenn mindestens ein Übergabeparameter nicht in eine Zahl konvertiert werden kann wird NaN zurückgegeben.

Beispeile

Einsatz von Math.min()

Dies findet den kleinsten Wert aus x und y und weist diesen z zu.

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

Wert mittels Math.min() begrenzen

Math.min() wird oftmals verwendet um einen Wert so zu begrenzen, dass dieser nicht größer als ein gesetztes Limit werden kann. So kann dies

var x = f(foo);

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

auch folgendermaßen formuliert werden

var x = Math.min(f(foo), limit);

Analog kann Math.max() verwendet werden um einen Mindestwert zu realisieren.

Spezifikationen

Spezifikation Status Kommentar
ECMAScript 1st Edition (ECMA-262) Standard Initiale Definition. Implementiert in JavaScript 1.0.
ECMAScript 5.1 (ECMA-262)
Die Definition von 'Math.min' in dieser Spezifikation.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Math.min' in dieser Spezifikation.
Standard  
ECMAScript Latest Draft (ECMA-262)
Die Definition von 'Math.min' in dieser Spezifikation.
Entwurf  

Browserkompatibilität

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Grundlegende Unterstützung Ja Ja1 Ja Ja Ja
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Grundlegende Unterstützung Ja Ja Ja4 Ja Ja Ja

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

Schlagwörter: 
 Mitwirkende an dieser Seite: schlagi123, cedrichaase, SSchnitzler
 Zuletzt aktualisiert von: schlagi123,