CKTIS / JavaScript
Number — konwersja wartości na liczbę
Number(value) przekształca wartość na prymitywną liczbę typu number. Poznaj różnicę między konwersją a obiektem new Number(value) oraz zamianę liczby na tekst przez Number.prototype.toString.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
Number(value)
Number()
new Number(value)
number.toString(radix)Number(value) zwraca prymitywną wartość typu number; Number() zwraca 0. Natomiast new Number(value) tworzy obiekt opakowujący: jego typeof to "object", a nie "number". Do zwykłych obliczeń i konwersji wybieraj wywołanie bez new.
Konwersja tekstu uwzględnia cały zapis po usunięciu białych znaków z obu końców: Number("255px") daje NaN, a Number("") daje 0. Number(null) daje 0, Number(undefined) daje NaN, a wartości logiczne stają się 1 lub 0. Konwersja Symbol zgłasza TypeError. Number może jawnie przekształcić BigInt, ale wynik może utracić precyzję.
Typ number używa formatu binarnego IEEE 754 o podwójnej precyzji: wiele ułamków dziesiętnych jest przybliżonych. Bezpieczny zakres liczb całkowitych wynosi od -(2 ** 53 - 1) do 2 ** 53 - 1; poza nim nie każda liczba całkowita jest reprezentowana dokładnie.
Number.prototype.toString działa w przeciwną stronę: value.toString(radix) zwraca tekst. Domyślna podstawa to 10; używaj całkowitej podstawy od 2 do 36, np. 16 dla zapisu szesnastkowego. Podstawa poza zakresem po konwersji zgłasza RangeError. Metoda wymaga liczby lub obiektu Number jako this; inny odbiorca powoduje TypeError.
Przykłady
const value = Number(" 255 ");
console.log(typeof value);
console.log(value);
console.log(value.toString(16));
console.log(Number(""));
console.log(Number.isNaN(Number("255px")));Wynik
number 255 ff 0 true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.
Źródła
- ECMAScript® Language Specification
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- ECMAScript® Language Specification — The Number Constructor
- ECMAScript® Language Specification — Number.prototype.toString
- ECMAScript® Language Specification — Numbers and Dates
- ECMAScript® Language Specification — ECMAScript Data Types and Values
- Official reference — developer.mozilla.org: Number / toString