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

<noinclude>{{DISPLAYTITLE:<code>Math.abs()‎</code>}}</noinclude>
الدالة <code>Math.abs()‎</code> تُعيد القيمة المطلقة للعدد، أي |x|، وتساوي x إذا كانت قيمة x أكبر من 0، وتساوي 0 إذا كانت قيمة x تساوي 0، وتساوي ‎-x إذا كانت قيمة x أصغر من الصفر؛ أي في جميع الحالات ستكون القيمة المُعادة هي قيمة موجبة.

== البنية العامة ==
<syntaxhighlight lang="javascript">
Math.abs(x)
</syntaxhighlight>

=== <code>x</code> ===
العدد التي ستُجرى عليه العملية.

=== القيمة المعادة ===
القيمة المطلقة للعدد المُعطى.

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

== أمثلة ==

تمرير كائن فارغ، أو مصفوفة فيها أكثر من رقم، أو سلسلة نصية ليست رقمية، أو متغير فارغ أو قيمته <code>[[JavaScript/undefined|undefined]]</code>، سيؤدي إلى إعادة القيمة <code>[[JavaScript/NaN|NaN]]</code>؛ أما تمرير <code>[[JavaScript/null|null]]</code> أو سلسلة نصية فارغة ستُعيد القيمة <code>0</code>:<syntaxhighlight lang="javascript">
Math.abs('-1');     // 1
Math.abs(-2);       // 2
Math.abs(null);     // 0
Math.abs('');       // 0
Math.abs([]);       // 0
Math.abs([2]);      // 2
Math.abs([1,2]);    // NaN
Math.abs({});       // NaN
Math.abs('string'); // NaN
Math.abs();         // NaN
</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-math.abs ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-math.abs ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.8.2.1 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]]