Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Number.prototype.toExponential: notação exponencial

toExponential devolve texto exponencial com um dígito antes do ponto e a quantidade pedida depois.

Versão: ECMAScript 3 onward; example target: Node.js 24.22.2

Sintaxe

number.toExponential(fractionDigits)

number.toExponential(fractionDigits) formata um Number como texto decimal com e minúsculo, sinal explícito do expoente e um dígito antes do ponto. Se fractionDigits for undefined, escolhe a sequência mais curta que identifica o Number sem ambiguidade. Quando fornecido, o resultado tem exatamente essa quantidade de dígitos após o ponto.

O argumento passa por ToIntegerOrInfinity: frações são truncadas em direção a zero e NaN torna-se 0. Para um recetor finito aceita-se 0..100; valores fora do intervalo e ±Infinity lançam RangeError. Contudo, o argumento é convertido primeiro e um recetor não finito devolve texto antes da validação: Infinity.toExponential(101) dá "Infinity"; um objeto argumento ainda pode lançar durante a conversão.

O método existe desde ECMAScript 3, não é genérico e lança TypeError se o recetor não for Number nem Number encapsulado. Arredonda para o resultado matemático mais próximo e, num empate após separar o sinal, escolhe a maior magnitude; a representação binária pode surpreender. O zero negativo é formatado sem sinal menos.

Exemplos

console.log((1234.5).toExponential(2), (0.00125).toExponential(2));
console.log((7).toExponential(), (-0).toExponential(1));
console.log(Infinity.toExponential(101));
try { console.log((1).toExponential(101)); } catch (error) { console.log(error.name); }
try { Number.prototype.toExponential.call("1", 2); } catch (error) { console.log(error.name); }

Resultado

1.23e+3 1.25e-3
7e+0 0.0e+0
Infinity
RangeError
TypeError

O exemplo mostra dígitos fixos, argumento omitido, -0 e a ordem entre Infinity e RangeError.

Fontes