Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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