CKTIS / JavaScript
HTMLInputElement.valueAsNumber — de numerieke waarde van een invoerveld
Lees en schrijf de numerieke waarde van een invoerveld. Herken NaN en houd er rekening mee dat de conversie afhangt van het invoertype.
Versie: 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 leest de waarde van een invoerveld als getal, terwijl value tekst bevat. Dit is een browser-API uit de HTML Standard, geen ECMAScript-functie.
Een leeg invoerveld van het type number, een mislukte conversie of een niet-ondersteund type geeft NaN terug. Controleer dit met Number.isNaN(). Zoals het voorbeeld laat zien, maak je een invoerveld van het type number leeg door NaN aan valueAsNumber toe te wijzen. Het type range ondersteunt valueAsNumber ook, maar de normalisatieregels voor dit type vervangen de lege tekenreeks door een numerieke standaardwaarde. Oneindigheid toewijzen veroorzaakt TypeError, en een eindig getal toewijzen aan een niet-ondersteund type veroorzaakt InvalidStateError.
De conversie hangt af van type: datum- en tijdtypen hebben hun eigen numerieke representaties. Een numeriek resultaat garandeert niet dat aan min, max of step wordt voldaan; controleer de validatie afzonderlijk.
Het voorbeeld gebruikt een niet aan het document gekoppeld number-invoerveld. Het vereist een browser-DOM; Node 24 alleen toont niet aan dat de functie wordt ondersteund.
Voorbeelden
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));Resultaat
14.5 "7" "" true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.