CKTIS / JavaScript
HTMLInputElement.valueAsNumber — številska vrednost vnosnega polja
Berite in zapisujte številsko vrednost vnosnega polja. Prepoznajte NaN in upoštevajte, da je pretvorba odvisna od vrste polja.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
input.valueAsNumber
input.valueAsNumber = numberHTMLInputElement.valueAsNumber prebere vrednost vnosnega polja kot število, medtem ko value vsebuje besedilo. To je API brskalnika, opredeljen v standardu HTML Standard, in ne funkcija ECMAScript.
Prazno polje number, neuspešna pretvorba ali nepodprta vrsta vrne NaN. Rezultat preverite z Number.isNaN(). Če lastnosti valueAsNumber dodelite NaN, se polje vrste number izprazni, kot kaže primer. Tudi vrsta range podpira valueAsNumber, vendar njena pravila za normalizacijo vrednosti nadomestijo prazen niz s privzeto številsko vrednostjo. Dodelitev neskončnosti sproži TypeError, dodelitev končnega števila nepodprti vrsti pa sproži InvalidStateError.
Pretvorba je odvisna od type: vrste za datum in čas imajo lastne številske predstavitve. Številski rezultat ne zagotavlja upoštevanja min, max ali step; preverjanje veljavnosti opravite posebej.
Primer uporablja polje number, ki ni dodano v dokument. Potrebuje DOM brskalnika; sam Node 24 ne dokazuje podpore.
Primeri
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));Rezultat
14.5 "7" "" true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.