CKTIS / JavaScript
HTMLInputElement.valueAsNumber — il valore numerico di un campo di input
Leggi e imposta il valore numerico di un campo di input. Riconosci NaN e ricorda che la conversione dipende dal tipo del campo.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
input.valueAsNumber
input.valueAsNumber = numberHTMLInputElement.valueAsNumber legge il valore di un campo di input come numero, mentre value contiene testo. È un’API del browser definita dall’HTML Standard, non una funzionalità ECMAScript.
Un campo number vuoto, una conversione non riuscita o un tipo non supportato restituisce NaN. Verifica il risultato con Number.isNaN(). Assegnare NaN a valueAsNumber svuota un campo di tipo number, come mostra l’esempio. Anche il tipo range supporta valueAsNumber, ma le sue regole di normalizzazione sostituiscono la stringa vuota con un valore numerico predefinito. Assegnare l’infinito genera TypeError, mentre assegnare un numero finito a un tipo non supportato genera InvalidStateError.
La conversione dipende da type: i tipi data e ora hanno rappresentazioni numeriche proprie. Un risultato numerico non garantisce il rispetto di min, max o step; controlla la validazione separatamente.
L’esempio usa un campo number non inserito nel documento. Richiede un DOM del browser; Node 24 da solo non dimostra il supporto.
Esempi
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));Risultato
14.5 "7" "" true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.