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

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

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

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

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

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

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

== أمثلة ==

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

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