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

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

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

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

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

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

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

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

== أمثلة ==
أمثلة عن استخدام الدالة <code>Math.log10()‎</code>:<syntaxhighlight lang="javascript">
Math.log10(2);      // 0.3010299956639812
Math.log10(1);      // 0
Math.log10(0);      // -Infinity
Math.log10(-2);     // NaN
Math.log10(100000); // 5
</syntaxhighlight>

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

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

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