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

<noinclude>{{DISPLAYTITLE:<code>Math.acos()‎</code>}}</noinclude>
الدالة <code>Math.acos()‎</code> معكوس التجيب (arccosine) للعدد بواحدة الراديان. أي لو أعادت هذه الدالة العدد y الذي ينتمي إلى المجال [0 ; π] فسيكون التعبير الرياضي cos(y) = x محققًا.

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

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

=== القيمة المعادة ===
معكوس التجيب (arccosine) للعدد بواحدة الراديان إذا كان بين -1 و 1، وإلا فستُعاد القيمة <code>[[JavaScript/NaN|NaN]]</code>.

== الوصف ==
الدالة <code>Math.acos(x)‎</code> تُعيد قيمةً عدديةً بين 0 و π إذا كانت قيمة <code>x</code> بين -1 و 1؛ وإذا كانت قيمة <code>x</code> خارج ذاك المجال، فستُعاد القيمة <code>[[JavaScript/NaN|NaN]]</code>.

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

== أمثلة ==

لاحظ أنَّ الدالة <code>Math.acos(x)‎</code> تُعيد <code>[[JavaScript/NaN|NaN]]</code> للقيم الأقل من -1 والأكبر من 1: <syntaxhighlight lang="javascript">
Math.acos(-2);  // NaN
Math.acos(-1);  // 3.141592653589793
Math.acos(0);   // 1.5707963267948966
Math.acos(0.5); // 1.0471975511965979
Math.acos(1);   // 0
Math.acos(2);   // NaN

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-math.acos ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-math.acos ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.8.2.2 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf ECMAScript 1st Edition] . 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Math|{{SUBPAGENAME}}]]