CKTIS / JavaScript
HTMLInputElement.valueAsNumber — la valeur numérique d’un champ de saisie
Lisez et modifiez la valeur numérique d’un champ de saisie. Repérez NaN et gardez à l’esprit que la conversion dépend du type du champ.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
input.valueAsNumber
input.valueAsNumber = numberHTMLInputElement.valueAsNumber lit la valeur d’un champ de saisie sous forme de nombre, tandis que value contient du texte. Il s’agit d’une API de navigateur définie par le HTML Standard, et non d’une fonctionnalité ECMAScript.
La lecture renvoie NaN si le champ number est vide, si la conversion échoue ou si le type n’est pas pris en charge. Vérifiez le résultat avec Number.isNaN(). Affecter NaN à valueAsNumber vide un champ de type number, comme le montre l’exemple. Le type range prend également en charge valueAsNumber, mais ses règles de normalisation remplacent la chaîne vide par une valeur numérique par défaut. Affecter l’infini déclenche TypeError, et affecter un nombre fini à un type non pris en charge déclenche InvalidStateError.
La conversion dépend de type : les types date et heure ont leurs propres représentations numériques. Un résultat numérique ne garantit pas le respect de min, max ou step ; vérifiez la validation séparément.
L’exemple utilise un champ number détaché du document. Il nécessite un DOM de navigateur ; Node 24 seul ne suffit pas à établir la prise en charge.
Exemples
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));Résultat
14.5 "7" "" true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.