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

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidEdge MobileFirefox für AndroidOpera für AndroidSafari auf iOSSamsung InternetNode.js
Grundlegende UnterstützungChrome Vollständige Unterstützung JaEdge Vollständige Unterstützung JaFirefox Vollständige Unterstützung 1IE Vollständige Unterstützung JaOpera Vollständige Unterstützung JaSafari Vollständige Unterstützung JaWebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung JaEdge Mobile Vollständige Unterstützung JaFirefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung JaSamsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung Ja

Legende

Vollständige Unterstützung  
Vollständige Unterstützung

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

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