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

<noinclude>{{DISPLAYTITLE:<code>Math.log2()‎</code>}}</noinclude>
الدالة <code>Math.log2()‎</code> تعيد اللوغاريتم الثنائي (ذو الأساس 2) للعدد المعطي، أي لو أعادت هذه الدالة القيمة y فسيكون التعبير الرياضي 2<sup>y</sup> = x محققًا.

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

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

=== القيمة المعادة ===
اللوغاريتم الثنائي (ذو الأساس 2) للعدد المعطي، وإذا كان العدد سالبًا فستُعاد القيمة <code>[[JavaScript/NaN|NaN]]</code>.

== الوصف ==
إذا كانت قيمة الوسيط x سالبةً، فستُعيد هذه الدالة القيمة <code>[[JavaScript/NaN|NaN]]</code> دومًا.

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

هذه الدالة تكافئ استخدام <code>Math.log(x) / Math.log(2)‎</code>، وللحصول على قيمة log2(e)‎ فاستخدم الثابت <code>[[JavaScript/Math/LOG2E|Math.LOG2E]]</code>، الذي هو <code>‎1 / [[JavaScript/Math/LN2|Math.LN2]]‎</code>.

== أمثلة ==
أمثلة عن استخدام الدالة <code>Math.log2()‎</code>:<syntaxhighlight lang="javascript">
Math.log2(3);    // 1.584962500721156
Math.log2(2);    // 1
Math.log2(1);    // 0
Math.log2(0);    // -Infinity
Math.log2(-2);   // NaN
Math.log2(1024); // 10
</syntaxhighlight>

== تعويض نقص دعم المتصفحات ==
يمكن محاكاة الدالة باستخدام الدالة الآتية:<syntaxhighlight lang="javascript">
Math.log2 = Math.log2 || function(x) {
  return Math.log(x) * Math.LOG2E;
};
</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|38
|25
|غير مدعومة
|25
|8
|}
على النقيض من متصفح IE، يدعم متصفح Edge هذه الميزة.

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-math.log2 ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-math.log2 ECMAScript 2015 (6th Edition)]‎. 
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Global Objects]]
[[تصنيف:JavaScript Math]]