عرض مصدر JavaScript/Number

<noinclude>{{DISPLAYTITLE:الكائن <code>Number</code> في JavaScript}}</noinclude>
الكائن <code>Number</code> هو كائن مُغلِّف (wrapper object) الذي يسمح لك بالعمل مع القيم العددية، وتُنشَأ كائنات <code>Number</code> باستخدام الدلة البانية <code>Number()‎</code>.
==البنية العامة==
<syntaxhighlight lang="javascript">
new Number(value);

</syntaxhighlight>

=== <code>value</code> ===
القيمة العددية التي سيحملها الكائن المُنشَأ.

== الوصف ==
الاستخدامات الأساسية لكائنات <code>Number</code> هي: 
* إذا لم يكن بالإمكان تحول الوسيط المُمرَّر إلى الدالة البانية إلى قيمة رقمية، فستُعاد القيمة <code>[[JavaScript/NaN|NaN]]</code>. 
* عند استخدام الدالة <code>Number</code> دون المعامل <code>[[JavaScript/new|new]]</code> (أي أنها ليست دالةً بانيةً)، فيمكن أن تُستخدَم لإجراء تحويل بين أنواع القيم. 

== الخاصيات التابعة للدالة البانية <code>Number</code> ==

=== <code>[[JavaScript/Number/EPSILON|Number.EPSILON]]</code> ===
أقل قيمة تفصل بين رقمين يمكن تمثيلهما في JavaScript.

=== <code>[[JavaScript/Number/MAX-SAFE-INTEGER|Number.MAX_SAFE_INTEGER]]</code> ===
أكبر قيمة «آمنة» للأعداد الصحيحة في JavaScript (وهي <code>2<sup>53</sup>‎ -1</code>).

=== <code>[[JavaScript/Number/MAX-VALUE|Number.MAX_VALUE]]</code> ===
أكبر عدد موجب يمكن تمثيله.

=== <code>[[JavaScript/Number/MIN-SAFE-INTEGER|Number.MIN_SAFE_INTEGER]]</code> ===
أكبر قيمة «آمنة» للأعداد الصحيحة في JavaScript (وهي <code>(2<sup>53</sup>‎ -1)-</code>).

=== <code>[[JavaScript/Number/MIN-VALUE|Number.MIN_VALUE]]</code> ===
أصغر عدد موجب يمكن تمثيله، أي أقرب رقم موجب إلى الصفر (لكنه ليس صفرًا).

=== <code>[[JavaScript/Number/NaN|Number.NaN]]</code> ===
قيمة خاصة هي Not-A-Number.

=== <code>[[JavaScript/Number/NEGATIVE-INFINITY|Number.NEGATIVE_INFINITY]]</code> ===
قيمة خاصة تمثِّل اللانهاية السالبة (ناقص لانهاية).

=== <code>[[JavaScript/Number/POSITIVE-INFINITY|Number.POSITIVE_INFINITY]]</code> ===
قيمة خاصة تمثِّل اللانهاية الموجبة (زائد لانهاية).

=== <code>[[JavaScript/Number/prototype|Number.prototype]]</code> ===
تسمح هذه الخاصية بإضافة خاصيات متاحة لجميع الكائنات التي نوعها هو <code>Number</code>.

== الدوال التابعة للدالة البانية <code>Number</code> ==

=== <code>[[JavaScript/Number/isNaN|Number.isNaN()‎]]</code> ===
تحديد إذا كانت القيمة المُمرَّرة هي <code>[[JavaScript/NaN|NaN]]</code> أم لا.

=== <code>[[JavaScript/Number/isFinite|Number.isFinite()‎]]</code> ===
تحديد إذا كانت القيمة المُمرَّرة هي عدد محدود أم لا.

=== <code>[[JavaScript/Number/isInteger|Number.isInteger()‎]]</code> ===
تحديد إذا كانت القيمة المُمرَّرة هي عددٌ صحيحٌ أم لا.

=== <code>[[JavaScript/Number/isSafeInteger|Number.isSafeInteger()‎]]</code> ===
تحديد إذا كانت القيمة المُمرَّرة هي عددٌ صحيحٌ آمن أم لا (أي أنَّ العدد بين ‎‎‎‎<code>-(2<sup>53</sup> - 1)‎</code> و <code>2<sup>53</sup>‎ - 1</code>)

=== <code>[[JavaScript/Number/parseFloat|Number.parseFloat()‎]]</code> ===
لها نفس عمل الدالة <code>[[JavaScript/parseFloat|parseFloat()‎]]</code> التابعة للكائن العام.

=== <code>[[JavaScript/Number/parseInt|Number.parseInt()‎]]</code> ===
لها نفس عمل الدالة <code>[[JavaScript/parseInt|parseInt()‎]]</code> التابعة للكائن العام.

== الكائن prototype ==
النسخ المُنشَأة من الدالة البانية <code>Number</code> ترث الدوال والخاصيات من كائن<code>Number.prototype</code>؛ وكما في جميع الدوال البانية، يمكنك إجراء تغييرات إلى كائن <code>prototype</code> في الدالة البانية لكي تنعكس تلك التعديلات إلى جميع نسخ الكائن <code>Number</code>.

=== الخاصيات ===

==== <code>Number.prototype.constructor</code> ====
تُحديد الدالة التي ستُنشِئ كائن prototype التابع للكائن <code>Number</code>؛ راجع صفحة الخاصية <code>[[JavaScript/Object/constructor|Object.prototype.constructor]]</code> لمزيدٍ من التفاصيل.

=== الدوال ===

==== <code>[[JavaScript/Number/toExponential|Number.prototype.toExponential()‎]]</code> ====
إعادة سلسلة نصية تُمثِّل العدد في شكل الكتابة العلمي (exponential notation).

==== <code>[[JavaScript/Number/toFixed|Number.prototype.toFixed()‎]]</code> ====
إعادة سلسلة نصية تُمثِّل العدد مع وضع فاصلة عشرية فيه (fixed-point notation).

==== <code>[[JavaScript/Number/toPrecision|Number.prototype.toPrecision()‎]]</code> ====
إعادة سلسلة نصية تُمثِّل العدد بالدقة المُحدَّدة بشكل الكتابة العلمي (exponential) أو مع وضع فاصلة عشرية (fixed-point).

==== <code>[[JavaScript/Number/toString|Number.prototype.toString()‎]]</code> ====
إعادة سلسلة نصية تُمثِّل العدد بالأساس العددي المُحدَّد (radix). وهي إعادة تعريف للدالة <code>[[JavaScript/Object/toString|Object.prototype.toString]]</code>.

==== <code>[[JavaScript/Number/valueOf|Number.prototype.valueOf()‎]]</code> ====
إعادة القيمة الأولية (primitive value) للكائن المُحدَّد. وهي إعادة تعريف للدالة <code>[[JavaScript/Object/valueOf|Object.prototype.valueOf]]</code>.

== أمثلة ==

=== استخدام الكائن <code>Number</code> لإسناد قيم رقمية إلى المتغيرات  ===
المثال الآتي يستخدم الخاصيات الساكنة (static properties) التابعة للكائن <code>Number</code> لإسناد قيم إلى عدِّة متغيرات رقمية:<syntaxhighlight lang="javascript">
var biggestNum = Number.MAX_VALUE;
var smallestNum = Number.MIN_VALUE;
var infiniteNum = Number.POSITIVE_INFINITY;
var negInfiniteNum = Number.NEGATIVE_INFINITY;
var notANum = Number.NaN;

</syntaxhighlight>

=== المجال العددي لكائنات <code>Number</code> ===
المثال الآتي يُظهِر أكبر وأصغر قيم عددية صحيحة يمكن تمثيلها في كائن <code>Number</code> (للتفاصيل، ارجع إلى معيار ECMAScript [https://tc39.github.io/ecma262/#sec-ecmascript-language-types-number-type القسم 6.1.6 المُعنوَن The Number Type]):<syntaxhighlight lang="javascript">
var biggestInt = 9007199254740991;
var smallestInt = -9007199254740991;

</syntaxhighlight>عند تفسير البيانات التي حوِّلَت إلى صيغة JSON، فستُعدّ القيم الخارجة عن هذا المجال غير صالحة عندما يحاول مُفسِّر JSON تحويلها إلى النوع <code>Number</code>، لذا يمكن استخدام نوع البيانات <code>[[JavaScript/String|String]]</code> كحل التفافي على هذه المشكلة.

=== استخدام <code>Number</code> لتحويل كائن <code>[[JavaScript/Date|Date]]</code> ===
المثال الآتي يحوّل الكائن <code>[[JavaScript/Date|Date]]</code> إلى قيمةٍ رقمية باستخدام <code>Number</code> كدالة:<syntaxhighlight lang="javascript">
var d = new Date('December 17, 1995 03:24:00');
console.log(Number(d));

</syntaxhighlight>ناتج المثال السابق هو: <code>819199440000</code>.

=== تحويل السلاسل النصية التي تحوي أعدادًا إلى قيم عددية ===
<syntaxhighlight lang="javascript">
Number('123')     // 123
Number('12.3')    // 12.3
Number('')        // 0
Number('0x11')    // 17
Number('0b11')    // 3
Number('0o11')    // 9
Number('foo')     // NaN
Number('100a')    // NaN
</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
انظر إلى صفحة كل خاصية ودالة تابعة للكائن <code>Number</code> لتفاصيل عن دعم المتصفحات لها.

== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-number-objects ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-number-objects ECMAScript 2015 (6th Edition)]‎. أضاف هذا المعيار الخاصيات والدوال: <code>[[JavaScript/Number/EPSILON|EPSILON]]</code> و <code>[[JavaScript/Number/isFinite|isFinite]]</code> و <code>[[JavaScript/Number/isInteger|isInteger]]</code> و <code>[[JavaScript/Number/isNaN|isNaN]]</code> و <code>[[JavaScript/Number/parseFloat|parseFloat]]</code> و <code>[[JavaScript/Number/parseInt|parseInt]]</code>.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.7 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%201st%20edition,%20June%201997.pdf ECMAScript 1st Edition] . 
[[تصنيف:JavaScript|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Global Objects|{{SUBPAGENAME}}]]
[[تصنيف:JavaScript Number|{{SUBPAGENAME}}]]
__NOEDITSECTION__