JavaScript/Math/min

الدالة Math.min()‎ تعيد أصغر قيمة من بين الوسائط المُمرَّرة إليها.

البنية العامة

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

value1, value2, ...‎

الأعداد التي ستُجرى عليها العملية.

القيمة المعادة

أصغر قيمة من الأعداد المُمرَّرة إلى الدالة، وإذا لم يكن بالإمكان تحويل أحد الوسائط على الأقل إلى قيمةٍ رقمية، فستُعاد القيمة NaN.

الوصف

لمّا كانت الدالة min هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل Math.min(x)‎، إذ لا تستطيع استخدامها كجزء من كائن Math خاص بك (تذكر أنَّ الكائن Math ليس له دالةٌ بانية).

إذا لم يكن بالإمكان تحويل أحد الوسائط على الأقل إلى قيمةٍ رقمية، فستُعاد القيمة NaN.

إذا لم تُمرَّر أيّة وسائط إلى الدالة، فالنتيجة هي ‎-Infinity.

أمثلة

أمثلة عن استخدام الدالة Math.min()‎

الشيفرة الآتية تعثر على أصغر قيمة بين x و y وتُسنِدها إلى z:

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

وضع حد أقصى للقيم

تُستخدَم الدالة min عادةً للحرص على ألّا تتجاوز قيمةٌ ما حدًا معيّنًا، فمثلًا الشيفرة الآتية:

var x = f(foo);

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

يمكن أن تكتب هكذا:

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

يمكن استخدام الدالة Math.max()‎ بطريقةٍ مشابهة لوضع حد أدنى للقيم.

الحصول على أصغر قيمة من مصفوفة

انظر إلى صفحة الدالة Math.max()‎ لمزيدٍ من التفاصيل.

دعم المتصفحات

الميزة	Chrome	Firefox	Internet Explorer	Opera	Safari
الدعم الأساسي	نعم	نعم	نعم	نعم	نعم

مصادر ومواصفات

• مسودة المعيار ECMAScript Latest Draft.
• معيار ECMAScript 2015 (6th Edition)‎.
• معيار ECMAScript 5.1.
• معيار ECMAScript 1st Edition .