RangeError: precision is out of range

The JavaScript exception "precision is out of range" occurs when a number that's outside of the allowed range was passed into toExponential, toFixed, or toPrecision.

Message#

RangeError: toExponential() argument must be between 0 and 100 (V8-based & Safari)
RangeError: toFixed() digits argument must be between 0 and 100 (V8-based & Safari)
RangeError: toPrecision() argument must be between 1 and 100 (V8-based & Safari)
RangeError: precision -1 out of range (Firefox)

Error type#

{{jsxref("RangeError")}}

What went wrong?#

There was an out of range precision argument in one of these methods:

• {{jsxref("Number.prototype.toExponential()")}}, which requires the arguments to be between 0 and 100, inclusive.
• {{jsxref("Number.prototype.toFixed()")}}, which requires the arguments to be between 0 and 100, inclusive.
• {{jsxref("Number.prototype.toPrecision()")}}, which requires the arguments to be between 1 and 100, inclusive.

Examples#

Invalid cases#

```js example-bad (77.1234).toExponential(-1); // RangeError (77.1234).toExponential(101); // RangeError

(2.34).toFixed(-100); // RangeError (2.34).toFixed(1001); // RangeError

(1234.5).toPrecision(-1); // RangeError (1234.5).toPrecision(101); // RangeError

### Valid cases

```js example-good
(77.1234).toExponential(4); // 7.7123e+1
(77.1234).toExponential(2); // 7.71e+1

(2.34).toFixed(1); // 2.3
(2.35).toFixed(1); // 2.4 (note that it rounds up in this case)

(5.123456).toPrecision(5); // 5.1235
(5.123456).toPrecision(2); // 5.1
(5.123456).toPrecision(1); // 5

See also#

• {{jsxref("Number.prototype.toExponential()")}}
• {{jsxref("Number.prototype.toFixed()")}}
• {{jsxref("Number.prototype.toPrecision()")}}