JavaScript/isFinite

الدالة isFinite()‎ تُحدِّد فيما إذا كانت القيمة المُمرَّرة إليها هي عددٌ محدود (finite number)، وسيحوَّل الوسيط إلى رقم إن كان ذلك ضروريًا.

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

isFinite(testValue)

testValue

القيمة التي ستُختبَر إن كانت عددًا محدودًا (finite number).

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

القيمة false إذا كانت قيمة الوسيط هي Infinity (سواءً كانت موجبةً أو سالبةً) أو NaN؛ وعدا ذلك ستُعيد القيمة true.

الوصف

الدالة isFinite هي دالةٌ غير مرتبطةٍ بأيّ كائن، ويمكن استخدام هذه الدالة لمعرفة إذا كان الوسيط المُمرَّر إليها هو عددٌ محدود، وإذا كنت قيمة الوسيط المُمرَّر هي NaN أو زائد لانهاية أو ناقص لانهاية فستُعيد الدالةُ القيمةَ false، وخلا ذلك ستُعيد true.

أمثلة

ستُعيد الدالة isFinite القيمة false في التعابير البرمجية الآتية:

isFinite(Infinity);  // false
isFinite(NaN);       // false
isFinite(-Infinity); // false

وستعيد القيمة true في التعابير البرمجية الآتية:

isFinite(0);         // true
isFinite(2e64);      // true
isFinite(910);       // true

لاحظ أنَّ الدالة isFinite ستُعيد القيمة true في التعابير البرمجية الآتية، لكن الدالة Number.isFinite ستُعيد القيمة false:

isFinite(null);      // true
isFinite('0');       // true

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

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

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

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