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.