CKTIS / JavaScript
HTMLInputElement.valueAsNumber — číselná hodnota vstupného poľa
Čítajte a zapisujte číselnú hodnotu vstupného poľa. Rozpoznávajte NaN a pamätajte, že konverzia závisí od typu poľa.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
input.valueAsNumber
input.valueAsNumber = numberHTMLInputElement.valueAsNumber číta hodnotu vstupného poľa ako číslo, zatiaľ čo value obsahuje text. Ide o API prehliadača definované štandardom HTML Standard, nie o funkciu ECMAScriptu.
Prázdne pole typu number, neúspešná konverzia alebo nepodporovaný typ vracia NaN. Výsledok overte pomocou Number.isNaN(). Priradenie NaN do valueAsNumber vyprázdni pole typu number, ako ukazuje príklad. Typ range tiež podporuje valueAsNumber, ale jeho pravidlá úpravy hodnoty nahradia prázdny reťazec predvolenou číselnou hodnotou. Priradenie nekonečna vyvolá TypeError a priradenie konečného čísla nepodporovanému typu vyvolá InvalidStateError.
Konverzia závisí od type: typy dátumu a času majú vlastné číselné reprezentácie. Číselný výsledok nezaručuje dodržanie min, max ani step; validáciu kontrolujte osobitne.
Príklad používa pole number, ktoré nie je pripojené k dokumentu. Vyžaduje DOM prehliadača; samotný Node 24 podporu nedokazuje.
Príklady
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));Výsledok
14.5 "7" "" true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.