JavaScript/Math/asinh

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

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

Math.asinh(x)

x

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

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

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

الوصف

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

أمثلة

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

Math.asinh(1);  // 0.881373587019543
Math.asinh(0);  // 0

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

التعبير الرياضي arcsinh(x) = ln (x + sqrt(x^2 +1))‎ صحيحٌ، لذا يمكن محاكاة التعبير الرياضي السابق بالدالة الآتية:

Math.asinh = Math.asinh || function(x) {
  if (x === -Infinity) {
    return x;
  } else {
    return Math.log(x + Math.sqrt(x * x + 1));
  }
};

عى الرغم من أنَّ الدالة السابقة صحيحة تمامًا، لكنها تعاني من مشاكل تتعلق بالأعداد العشرية، فالنتائج الدقيقة تتطلب معالجةً خاصةً للوسائط الموجبة والسالبة والكبيرة والصغيرة، كما هو معمولٌ به في glibc أو GNU Scientific Library.

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

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

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

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

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