---
title: 'RangeError: precision is out of range'
slug: Web/JavaScript/Reference/Errors/Precision_range
tags:
  - Erro
  - Erros
  - JavaScript
  - RangeError
translation_of: Web/JavaScript/Reference/Errors/Precision_range
---
<div>{{jsSidebar("Errors")}}</div>

<p>A exceção JavaScript "precision is out of range" (precisão fora de alcance) ocorre quando um número que está fora do intervalo que vai de 0 à 20 (ou 21) foi passado para <code>toFixed</code> ou <code>toPrecision</code>.</p>

<h2 id="Mensagem">Mensagem</h2>

<pre class="syntaxbox">RangeError: The number of fractional digits is out of range (Edge)
RangeError: The precision is out of range (Edge)
RangeError: precision {0} out of range (Firefox)
RangeError: toExponential() argument must be between 0 and 20 (Chrome)
RangeError: toFixed() digits argument must be between 0 and 20 (Chrome)
RangeError: toPrecision() argument must be between 1 and 21 (Chrome)
</pre>

<h2 id="Tipo_de_erro">Tipo de erro</h2>

<p>{{jsxref("RangeError")}}</p>

<h2 id="O_que_houve_de_errado">O que houve de errado?</h2>

<p>Existe um argumento de precisão fora do intervalo em um desses métodos:</p>

<ul>
 <li>{{jsxref("Number.prototype.toExponential()")}}</li>
 <li>{{jsxref("Number.prototype.toFixed()")}}</li>
 <li>{{jsxref("Number.prototype.toPrecision()")}}</li>
</ul>

<p>Po padrão, o intervalo permitido para os métodos acima é de 0 à 20 (ou 21). Todavia, a especificação ECMAScript nos permite extender o intervalo.</p>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Método</th>
   <th scope="col">Firefox (SpiderMonkey)</th>
   <th scope="col">Chrome, Opera (V8)</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{jsxref("Number.prototype.toExponential()")}}</td>
   <td>0 to 100</td>
   <td>0 to 20</td>
  </tr>
  <tr>
   <td>{{jsxref("Number.prototype.toFixed()")}}</td>
   <td>-20 to 100</td>
   <td>0 to 20</td>
  </tr>
  <tr>
   <td>{{jsxref("Number.prototype.toPrecision()")}}</td>
   <td>1 to 100</td>
   <td>1 to 21</td>
  </tr>
 </tbody>
</table>

<h2 id="Exemplos">Exemplos</h2>

<h3 id="Casos_inválidos">Casos inválidos</h3>

<pre class="brush: 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
</pre>

<h3 id="Casos_válidos">Casos válidos</h3>

<pre class="brush: 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 (perceba que ele foi arredondado nesse caso)

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

<h2 id="Veja_também">Veja também</h2>

<ul>
 <li>{{jsxref("Number.prototype.toExponential()")}}</li>
 <li>{{jsxref("Number.prototype.toFixed()")}}</li>
 <li>{{jsxref("Number.prototype.toPrecision()")}}</li>
</ul>