CKTIS / JavaScript
HTMLInputElement.valueAsNumber — der Zahlenwert eines Eingabefelds
Lies und schreibe den Zahlenwert eines Eingabefelds. Erkenne NaN und beachte, dass die Umwandlung vom Eingabetyp abhängt.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
input.valueAsNumber
input.valueAsNumber = numberHTMLInputElement.valueAsNumber liest den Wert eines Eingabefelds als Zahl aus, während value Text enthält. Dies ist eine Browser-API des HTML-Standards und kein ECMAScript-Feature.
Ein leeres Eingabefeld vom Typ number, eine fehlgeschlagene Umwandlung oder ein nicht unterstützter Typ ergibt NaN. Prüfe das Ergebnis mit Number.isNaN(). Die Zuweisung von NaN an valueAsNumber leert ein Eingabefeld vom Typ number, wie das Beispiel zeigt. Der Typ range unterstützt valueAsNumber ebenfalls, aber seine Regeln zur Wertbereinigung ersetzen die leere Zeichenfolge durch einen numerischen Standardwert. Die Zuweisung von Unendlich löst TypeError aus, und die Zuweisung einer endlichen Zahl an einen nicht unterstützten Typ löst InvalidStateError aus.
Die Umwandlung hängt von type ab: Datums- und Uhrzeittypen haben eigene numerische Darstellungen. Ein numerisches Ergebnis garantiert nicht, dass min, max oder step eingehalten werden; prüfe die Validierung separat.
Das Beispiel verwendet ein nicht in das Dokument eingefügtes Eingabefeld vom Typ number. Es erfordert ein Browser-DOM; Node 24 allein belegt keine Unterstützung.
Beispiele
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));Ergebnis
14.5 "7" "" true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.