JavaScript/Math/acosh

الدالة Math.acosh()‎ معكوس التجيب القطعي (hyperbolic arccosine) للعدد. أي لو أعادت هذه الدالة العدد y وكان هذ العدد أكبر أو يساوي الصفر فسيكون التعبير الرياضي cosh(y) = x محققًا.

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

Math.acosh(x)

x

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

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

معكوس التجيب القطعي (hyperbolic arccosine) للعدد؛ وإذا كان العدد أصغر من 1 فستُعاد القيمة NaN.

الوصف

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

أمثلة

لاحظ أنَّ الدالة Math.acosh(x)‎ تُعيد NaN للقيم الأقل من 1:

Math.acosh(-1);  // NaN
Math.acosh(0);   // NaN
Math.acosh(0.5); // NaN
Math.acosh(1);   // 0
Math.acosh(2);   // 1.3169578969248166

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

لجميع قيم x التي تكون أكبر أو تساوي 1 (x≥1) فستكون arccosh(x) = ln (x + sqrt(x^2 -1))‎، لذا يمكن محاكاة التعبير الرياضي السابق بالدالة الآتية:

Math.acosh = Math.acosh || function(x) {
  return Math.log(x + Math.sqrt(x * x - 1));
};

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

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

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

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

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