CKTIS / JavaScript
HTMLInputElement.valueAsNumber — o valor numérico de um campo de entrada
Leia e escreva o valor numérico de um campo de entrada. Reconheça NaN e tenha em conta que a conversão depende do tipo do campo.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
input.valueAsNumber
input.valueAsNumber = numberHTMLInputElement.valueAsNumber lê o valor de um campo de entrada como número, enquanto value contém texto. É uma API de navegador definida pelo HTML Standard, não uma funcionalidade de ECMAScript.
Um campo number vazio, uma conversão falhada ou um tipo não suportado devolve NaN. Verifique o resultado com Number.isNaN(). Atribuir NaN a valueAsNumber esvazia um campo do tipo number, como mostra o exemplo. O tipo range também suporta valueAsNumber, mas as suas regras de normalização substituem a cadeia de caracteres vazia por um valor numérico predefinido. Atribuir infinito lança TypeError, e atribuir um número finito a um tipo não suportado lança InvalidStateError.
A conversão depende de type: os tipos de data e hora têm representações numéricas próprias. Um resultado numérico não garante o cumprimento de min, max ou step; verifique a validação separadamente.
O exemplo utiliza um campo number desligado do documento. Requer um DOM de navegador; o Node 24, por si só, não comprova o suporte.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.