JavaScript/Math/atanh

الدالة Math.atanh()‎ معكوس الظل القطعي (hyperbolic arctangent) للعدد. أي لو أعادت هذه الدالة العدد y فسيكون التعبير الرياضي tanh(y) = x محققًا.

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

Math.atanh(x)

x

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

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

معكوس التجيب القطعي (hyperbolic arctangent) للعدد.

الوصف

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

أمثلة

لاحظ أنَّ الدالة Math.atanh(x)‎ تُعيد NaN للقيم الأقل من -1 أو أكبر من 1:

Math.atanh(-2);  // NaN
Math.atanh(-1);  // -Infinity
Math.atanh(0);   // 0
Math.atanh(0.5); // 0.5493061443340548
Math.atanh(1);   // Infinity
Math.atanh(2);   // NaN

تعويض نقص دعم المتصفحات

لجميع قيم ‎|x| > 1 فستكون 2 / arctanh(x) = ln ((1+x)/(1-x))‎، لذا يمكن محاكاة التعبير الرياضي السابق بالدالة الآتية:

Math.atanh = Math.atanh || function(x) {
  return Math.log((1+x)/(1-x)) / 2;
};

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

الميزة	Chrome	Firefox	Internet Explorer	Opera	Safari
الدعم الأساسي	38	25	غير مدعومة	25	8

على النقيض من متصفح IE، يدعم متصفح Edge هذه الميزة.

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

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