Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

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

Sources