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

<noinclude>{{DISPLAYTITLE:<code>Number.prototype.toPrecision()‎</code>}}</noinclude>
الدالة <code>Number.prototype.toPrecision()‎</code> تُعيد سلسلةً نصيةً تُمثِّل العدد بدقة معيّنة.
== البنية العامة ==
<syntaxhighlight lang="javascript">
numObj.toPrecision([precision])

</syntaxhighlight>
===<code>precision</code>===
وسيطٌ اختياريٌ يُمثِّل عدد الأرقام المهمة.
===القيمة المعادة===
سلسلة نصيّة تُمثِّل الكائن <code>[[JavaScript/Number|Number]]</code> بالشكل العلمي (exponential) أو مع استخدام فاصلة عشرية (fixed-point) مُقرّبًا إلى قيمة الوسيط <code>precision</code>. راجع صفحة الدالة <code>[[JavaScript/Number/toFixed|Number.prototype.toFixed()‎]]</code> لشرحٍ وأمثلةٍ عن طريقة التقريب.

إذا لم تُحدَّد قيمة للوسيط <code>precision</code> فستسلك هذه الدالة سلوك الدالة <code>[[JavaScript/Number/toString|Number.prototype.toString()‎]]</code>، وإذا لم تكن قيمة الوسيط <code>precision</code> عددًا صحيحًا فستُقرّب القيمة إلى أقرب عدد صحيح.

=== الاستثناءات ===

==== <code>[[JavaScript/RangeError|RangeError]]</code> ====
سيرمى هذا الاستثناء إذا لم تكن قيمة الوسيط <code>precision</code> بين 1 و 100.

== أمثلة ==
مثال عن عدد أكبر من 1:<syntaxhighlight lang="javascript">
var numObj = 5.123456;

console.log(numObj.toPrecision());    // '5.123456'
console.log(numObj.toPrecision(5));   // '5.1235'
console.log(numObj.toPrecision(2));   // '5.1'
console.log(numObj.toPrecision(1));   // '5'

</syntaxhighlight>مثال عن عدد أصغر من 1:<syntaxhighlight lang="javascript">
var numObj = 0.000123

console.log(numObj.toPrecision());    // '0.000123'
console.log(numObj.toPrecision(5));   // '0.00012300'
console.log(numObj.toPrecision(2));   // '0.00012'
console.log(numObj.toPrecision(1));   // '0.0001' 

</syntaxhighlight>لاحظ أنَّه في بعض الأحيان ستُستخدَم الصيغة العلمية (exponential):<syntaxhighlight lang="javascript">
console.log((1234.5).toPrecision(2)); // '1.2e+3'

</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|نعم
|نعم
|نعم
|نعم
|نعم
|}
== مصادر ومواصفات ==
* مسودة المعيار [https://tc39.github.io/ecma262/#sec-number.prototype.toprecision ECMAScript Latest Draft].
* معيار [http://www.ecma-international.org/ecma-262/6.0/#sec-number.prototype.toprecision ECMAScript 2015 (6th Edition)]‎.
* معيار [http://www.ecma-international.org/ecma-262/5.1/#sec-15.7.4.7 ECMAScript 5.1].
* معيار [http://www.ecma-international.org/publications/files/ECMA-ST-ARCH/ECMA-262,%203rd%20edition,%20December%201999.pdf ECMAScript 3rd Edition]. 
[[تصنيف:JavaScript]]
[[تصنيف:JavaScript Global Objects]]
[[تصنيف:JavaScript Number]]