عرض مصدر JavaScript/Number/isSafeInteger

<noinclude>{{DISPLAYTITLE:<code>Number.isSafeInteger()‎</code>}}</noinclude>
الدالة <code>Number.isSafeInteger()‎</code> تُحدِّد إذا كانت القيمة المُمرَّرة إليها هي عددٌ صحيحٌ «آمن». العدد الصحيح الآمن هو عددٌ صحيحٌ الذي:
* يمكن تمثيله كعدد ذي فاصلة عشرية كما في معيار IEEE 754 بدقة
* وأن يكون تمثيله كما في معيار IEEE 754 لا يؤدي إلى تقريب أي عدد لكي يكون مُطابِقًا للمعيار.
على سبيل المثال، العدد ‎<code>2<sup>53</sup> - 1</code> هو عددٌ صحيحٌ آمن، فيمكن تمثيل قيمته كما هي، ولن يُقرّب أيُّ عدد فيه لنتمكن من تمثيله في معيار IEEE 754؛ لكن على النقيض مما سبق، العدد 2<sup>53</sup> ليس عددًا صحيحًا آمنًا على الرغم من إمكانية تمثيله في IEEE 754 بدقة، لكن العدد الصحيح <code>2<sup>53</sup>‎ + 1</code> لا يمكن تمثيله مباشرةً في IEEE 654 وإنما سيُقرّب إلى <code>2<sup>53</sup></code>. وبالتالي يكون مجال الأعداد الصحيحة الآمنة من ‎<code>-(2<sup>53</sup> - 1)</code>‎ إلى <code>2<sup>53</sup>‎ - 1</code> (أي <code>‎‎± 9007199254740991</code>).

== البنية العامة ==
<syntaxhighlight lang="javascript">
Number.isSafeInteger(value)

</syntaxhighlight>

=== <code>value</code> ===
القيمة التي ستُختبَر إن كانت عددًا صحيحًا آمنًا.

=== القيمة المعادة ===
قيمة منطقية <code>[[JavaScript/Boolean|Boolean]]</code> تُشير إذا كانت القيمة هي عددٌ صحيحٌ آمنٌ أم لا.

== أمثلة ==
<syntaxhighlight lang="javascript">
Number.isSafeInteger(3);                    // true
Number.isSafeInteger(Math.pow(2, 53));      // false
Number.isSafeInteger(Math.pow(2, 53) - 1);  // true
Number.isSafeInteger(NaN);                  // false
Number.isSafeInteger(Infinity);             // false
Number.isSafeInteger('3');                  // false
Number.isSafeInteger(3.1);                  // false
Number.isSafeInteger(3.0);                  // true

</syntaxhighlight>

== تعويض نقص دعم المتصفحات ==
<syntaxhighlight lang="javascript">
Number.isSafeInteger = Number.isSafeInteger || function (value) {
   return Number.isInteger(value) && Math.abs(value) <= Number.MAX_SAFE_INTEGER;
};

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|23
|غير مدعومة
|نعم
|نعم
|}
على النقيض من متصفح IE، يدعم متصفح Edge هذه الميزة.

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-number.issafeinteger ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-number.issafeinteger ECMAScript 2015 (6th Edition)]‎. 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Number|{{SUBPAGENAME}}]]