Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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 = number

HTMLInputElement.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.

Fonti