JavaScript/Math/log

الدالة Math.log()‎ تعيد اللوغاريتم الطبيعي (ذو الأساس e) للعدد المعطي، أي لو أعادت هذه الدالة القيمة y فسيكون التعبير الرياضي e^y = x محققًا.

الدالة Math.log()‎ في JavaScript تكافئ الدالة ln(x)‎ في الرياضيات.

البنية العامة

Math.log(x)

x

العدد التي ستُجرى عليه العملية.

القيمة المعادة

اللوغاريتم الطبيعي (ذو الأساس e) للعدد المعطي، وإذا كان العدد سالبًا فستُعاد القيمة NaN.

الوصف

إذا كانت قيمة الوسيط x سالبةً، فستُعيد هذه الدالة القيمة NaN دومًا.

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

إذا أردتَ الحصول على اللوغاريتم الطبيعي للعددين 2 أو 10 فاستخدم الثابتين Math.LN2 أو Math.LN10؛ وإذا أردتَ الحصول على اللوغاريتم ذو الأساس 2 أو 10 فاستخدم الدالتين Math.log2()‎ أو Math.log10()‎. أما إذا احتجت إلى اللوغاريتم بأساس مختلف، فاستخدم الصيغة  Math.log(x) / Math.log(otherBase)‎، وسنوضِّح ذلك في قسم الأمثلة.

أمثلة

أمثلة عن استخدام الدالة Math.log(x)‎

Math.log(-1); // NaN, out of range
Math.log(0);  // -Infinity
Math.log(1);  // 0
Math.log(10); // 2.302585092994046

استخدام الدالة Math.log()‎ مع أساس مختلف

الدالة الآتية تُعيد لوغاريتم العدد y الذي له الأساس x (أي log_xy):

function getBaseLog(x, y) {
  return Math.log(y) / Math.log(x);
}

إذا نفّذَت الدالة getBaseLog(10, 1000)‎ فستحصل على القيمة 2.9999999999999996 بسبب عدم دقة تمثيل الأعداد ذات الفاصلة العائمة، لكن هذه القيمة قريبة جدًا إلى الجواب الحقيقي 3.

دعم المتصفحات

الميزة	Chrome	Firefox	Internet Explorer	Opera	Safari
الدعم الأساسي	نعم	نعم	نعم	نعم	نعم

مصادر ومواصفات

• مسودة المعيار ECMAScript Latest Draft.
• معيار ECMAScript 2015 (6th Edition)‎.
• معيار ECMAScript 5.1.
• معيار ECMAScript 1st Edition .