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 = numberHTMLInputElement.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.