Die Math.min()
Funktion gibt den wert der kleinsten übergebenen Zahl zurück.
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-
Object 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
Beispiel: Math.min() verwenden
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);
Beispiel: Wert mittels Math.min() begrenzen
Math.min()
wird oftmals verwendet um einen wert so zu begrenzen, das 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 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 2017 Draft (ECMA-262) Die Definition von 'Math.min' in dieser Spezifikation. |
Entwurf |
Browserkompatibilität
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Ja) | (Ja) | (Ja) | (Ja) | (Ja) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Ja) | (Ja) | (Ja) | (Ja) | (Ja) | (Ja) |