Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Number.prototype.toExponential: zapis wykładniczy

toExponential zwraca tekst wykładniczy z jedną cyfrą przed kropką i zadaną liczbą cyfr po niej.

Wersja: ECMAScript 3 onward; example target: Node.js 24.22.2

Składnia

number.toExponential(fractionDigits)

number.toExponential(fractionDigits) formatuje Number jako dziesiętny tekst z małym e, jawnym znakiem wykładnika i jedną cyfrą przed kropką. Gdy fractionDigits jest undefined, metoda dobiera najkrótszą liczbę cyfr potrzebną do jednoznacznego wskazania wartości Number. Po podaniu argumentu wynik zawiera dokładnie tyle cyfr po kropce.

Argument przechodzi ToIntegerOrInfinity: ułamki są obcinane w stronę zera, a NaN staje się 0. Dla skończonego odbiorcy dozwolony zakres to 0..100; wartości poza nim i ±Infinity powodują RangeError. Najpierw jednak argument jest konwertowany, a następnie odbiorca nieskończony lub NaN zwraca zwykły tekst bez sprawdzania zakresu, więc Infinity.toExponential(101) daje "Infinity"; obiekt argumentu nadal może rzucić podczas konwersji.

Metoda istnieje od ECMAScript 3, nie jest generyczna i przy odbiorcy innym niż Number lub opakowany Number rzuca TypeError. Zaokrągla matematycznie do najbliższego wyniku, a remis po oddzieleniu znaku wybiera większą wartość bezwzględną; reprezentacja binarna może więc zaskakiwać. -0 jest formatowane bez znaku minus.

Przykłady

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); }

Wynik

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

Przykład pokazuje stałą liczbę cyfr, tryb bez argumentu, -0 oraz kolejność obsługi Infinity i RangeError.

Źródła