Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

HTMLInputElement.valueAsNumber — wartość pola jako liczba

Odczytuj i zapisuj liczbową wartość pola input. Rozpoznawaj NaN i pamiętaj, że konwersja zależy od typu pola.

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

input.valueAsNumber
input.valueAsNumber = number

HTMLInputElement.valueAsNumber odczytuje wartość pola jako liczbę, podczas gdy value przechowuje tekst. To API przeglądarki z HTML Standard, a nie funkcja ECMAScript.

Puste pole number, nieudana konwersja lub nieobsługiwany typ dają NaN. Sprawdzaj wynik przez Number.isNaN(). Przypisanie NaN do valueAsNumber czyści pole typu number, co pokazuje przykład. Typ range również obsługuje valueAsNumber, ale jego reguły normalizacji zastępują pusty ciąg domyślną wartością liczbową. Zapis nieskończoności rzuca TypeError, a skończonej liczby do nieobsługiwanego typu — InvalidStateError.

Konwersja zależy od type: typy daty i czasu mają własne reprezentacje liczbowe. Wynik liczbowy nie gwarantuje zgodności z min, max ani step; walidację sprawdzaj oddzielnie.

Przykład używa odłączonego pola number. Wymaga DOM przeglądarki; samo środowisko Node 24 nie dowodzi obsługi.

Przykłady

const input = document.createElement('input');
input.type = 'number';
input.step = 'any';
input.value = '12.5';
console.log(input.valueAsNumber + 2);

input.valueAsNumber = 7;
console.log(JSON.stringify(input.value));

input.valueAsNumber = NaN;
console.log(JSON.stringify(input.value));
console.log(Number.isNaN(input.valueAsNumber));

Wynik

14.5
"7"
""
true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła