`Number.prototype.toPrecision()‎`

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

الدالة Number.prototype.toPrecision()‎ تُعيد سلسلةً نصيةً تُمثِّل العدد بدقة معيّنة.

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

numObj.toPrecision([precision])

`precision`

وسيطٌ اختياريٌ يُمثِّل عدد الأرقام المهمة.

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

سلسلة نصيّة تُمثِّل الكائن Number بالشكل العلمي (exponential) أو مع استخدام فاصلة عشرية (fixed-point) مُقرّبًا إلى قيمة الوسيط precision. راجع صفحة الدالة Number.prototype.toFixed()‎ لشرحٍ وأمثلةٍ عن طريقة التقريب.

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

الاستثناءات

`RangeError`

سيرمى هذا الاستثناء إذا لم تكن قيمة الوسيط precision بين 1 و 100.

أمثلة

مثال عن عدد أكبر من 1:

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'

مثال عن عدد أصغر من 1:

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'

لاحظ أنَّه في بعض الأحيان ستُستخدَم الصيغة العلمية (exponential):

console.log((1234.5).toPrecision(2)); // '1.2e+3'

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

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

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

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