عرض مصدر JavaScript/Math/max

<noinclude>{{DISPLAYTITLE:<code>Math.max()‎</code>}}</noinclude>
الدالة <code>Math.max()‎</code> تعيد أكبر قيمة من بين الوسائط المُمرَّرة إليها.

== البنية العامة ==
<syntaxhighlight lang="javascript">
Math.max([value1[, value2[, ...]]])

</syntaxhighlight>

=== <code>value1, value2, ...‎</code> ===
الأعداد التي ستُجرى عليها العملية.

=== القيمة المعادة ===
أكبر قيمة من الأعداد المُمرَّرة إلى الدالة، وإذا لم يكن بالإمكان تحويل أحد الوسائط على الأقل إلى قيمةٍ رقمية، فستُعاد القيمة <code>[[JavaScript/NaN|NaN]]</code>.

== الوصف ==
لمّا كانت الدالة <code>max</code> هي دالةٌ ساكنة (static method) تابعةٌ للكائن Math، فيجب عليك استخدامها دومًا بالشكل <code>Math.max()‎</code>، إذ لا تستطيع استخدامها كجزء من كائن <code>Math</code> خاص بك (تذكر أنَّ الكائن <code>[[JavaScript/Math|Math]]</code> ليس له دالةٌ بانية).

إذا لم يكن بالإمكان تحويل أحد الوسائط على الأقل إلى قيمةٍ رقمية، فستُعاد القيمة <code>[[JavaScript/NaN|NaN]]</code>.

إذا لم تُمرَّر أيّة وسائط إلى الدالة، فالنتيجة هي ‎<code>-[[JavaScript/Infinity|Infinity]]</code>.

== أمثلة ==

=== أمثلة عن استخدام الدالة <code>Math.max()‎</code> ===
<syntaxhighlight lang="javascript">
Math.max(10, 20);   //  20
Math.max(-10, -20); // -10
Math.max(-10, 20);  //  20
</syntaxhighlight>

=== الحصول على أكبر قيمة من مصفوفة ===
يمكن استخدام الدالة <code>[[JavaScript/Array/reduce|Array.reduce()]]</code>‎ للحصول على أكبر عنصر في مصفوفة عددية بمقارنة القيم التي فيها:<syntaxhighlight lang="javascript">
var arr = [1, 2, 3];
var max = arr.reduce(function(a, b) {
    return Math.max(a, b);
});

</syntaxhighlight>الدالة الآتية تستخدم الدالة <code>[[JavaScript/Function/apply|Function.prototype.apply()‎]]</code> للحصول على أكبر قيمة في المصفوفة، لاحظ أنَّ استخدام الدالة <code>getMaxOfArray([1, 2, 3])‎</code> يكافئ استخدام <code>Math.max(1, 2, 3)‎</code>، لكن يمكنك استخدام الدالة <code>getMaxOfArray()‎</code> على المصفوفات المولّدة برمجيًا (أي التي لا تعرف ما هي عناصرها عند كتابة البرنامج)؛ ويجب استخدام هذه الطريقة للمصفوفات التي لها عناصر قليلة نسبيًا:<syntaxhighlight lang="javascript">
function getMaxOfArray(numArray) {
  return Math.max.apply(null, numArray);
}

</syntaxhighlight>[[JavaScript/Spread Operator|معامل النشر]] (spread operator) المُضاف حديثًا إلى اللغة هو طريقةٌ أقصر من استخدما الدالة <code>[[JavaScript/Function/apply|apply]]</code> للحصول على أكبر قيمة في المصفوفة:<syntaxhighlight lang="javascript">
var arr = [1, 2, 3];
var max = Math.max(...arr);

</syntaxhighlight>لكن لن يستطيع معامل النشر (<code>...</code>) والدالة <code>apply</code> من إعادة القيمة الصحيحة إذا كانت تملك المصفوفة عناصر كثيرة، وذلك لأنها تُمرِّر عناصر المصفوفة كمعاملات إلى الدوال، راجع صفحة الدالة <code>[[JavaScript/Function/apply|apply]]</code> لتفاصيل عن طريقة الالتفاف على هذه المحدودية؛ لاحظ أنَّ الدالة <code>[[JavaScript/Array/reduce|reduce]]</code> لا تعاني من هذه المشكلة.
== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-math.max ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-math.max ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.8.2.11 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf ECMAScript 1st Edition] . 
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Global Objects]]
[[تصنيف:JavaScript Math]]