CKTIS / JavaScript
HTMLInputElement.valueAsNumber — el valor numérico de un campo de entrada
Lee y escribe el valor numérico de un campo de entrada. Reconoce NaN y recuerda que la conversión depende del tipo del campo.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
input.valueAsNumber
input.valueAsNumber = numberHTMLInputElement.valueAsNumber lee el valor de un campo de entrada como número, mientras que value contiene texto. Es una API del navegador definida por HTML Standard, no una característica de ECMAScript.
Un campo number vacío, una conversión fallida o un tipo no compatible devuelve NaN. Comprueba el resultado con Number.isNaN(). Asignar NaN a valueAsNumber vacía un campo de tipo number, como muestra el ejemplo. El tipo range también admite valueAsNumber, pero sus reglas de normalización sustituyen la cadena vacía por un valor numérico predeterminado. Asignar infinito lanza TypeError, y asignar un número finito a un tipo no compatible lanza InvalidStateError.
La conversión depende de type: los tipos de fecha y hora tienen sus propias representaciones numéricas. Un resultado numérico no garantiza que se cumplan min, max o step; comprueba la validación por separado.
El ejemplo usa un campo number separado del documento. Requiere un DOM de navegador; Node 24 por sí solo no demuestra que haya compatibilidad.
Ejemplos
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));Resultado
14.5 "7" "" true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.