JavaScript/Math/cbrt

الدالة Math.cbrt()‎ تعيد الجذر التكعيبي (cube root) للعدد. أي لو أعادت هذه الدالة العدد y فسيكون التعبير الرياضي y³ = x محققًا.

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

Math.cbrt(x)

x

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

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

الجذر التكعيبي (cube root) للعدد.

الوصف

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

أمثلة

أمثلة عددية:

Math.cbrt(NaN); // NaN
Math.cbrt(-1); // -1
Math.cbrt(-0); // -0
Math.cbrt(-Infinity); // -Infinity
Math.cbrt(0); // 0
Math.cbrt(1); // 1
Math.cbrt(Infinity); // Infinity
Math.cbrt(null); // 0
Math.cbrt(2);  // 1.2599210498948734

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

لجميع قيم x≥0، سيكون الجذر التكعيبي هو رفع العدد x إلى القوة 1/3 أي x^1/3، لذا يمكن محاكاة التعبير الرياضي السابق بالدالة الآتية:

if (!Math.cbrt) {
  Math.cbrt = function(x) {
    var y = Math.pow(Math.abs(x), 1/3);
    return x < 0 ? -y : y;
  };
}

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

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

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

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

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