CKTIS / JavaScript
HTMLInputElement.value — den Wert eines Eingabefelds lesen und setzen
HTMLInputElement.value liest einen Wert als Zeichenfolge aus oder setzt ihn. Das Verhalten hängt von type ab; bei einem Texteingabefeld kann der aktuelle Wert vom Standardwert abweichen.
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.value
input.value = "new value";HTMLInputElement.value ist eine Eigenschaft der Web API und nicht von ECMAScript selbst. Sie gibt eine Zeichenfolge zurück, auch bei type="number"; zum Auslesen einer Zahl verwenden Sie valueAsNumber. Dafür ist eine Browser-DOM-Umgebung erforderlich, Node.js allein reicht nicht aus.
Bei einem Texteingabefeld steht .value für den aktuellen Wert. defaultValue gibt das HTML-Attribut value wieder. Durch eine Zuweisung an .value wird intern ein Änderungskennzeichen für den Wert gesetzt: Nachfolgende Änderungen am Attribut aktualisieren den aktuellen Wert nicht mehr, bis dieses Kennzeichen zurückgesetzt wird, etwa durch das Zurücksetzen des Formulars. Die Zuweisung löst nicht automatisch input- oder change-Ereignisse aus.
Der Browser wendet je nach type unterschiedliche Regeln zur Bereinigung an: Ein ungültiger Zahlenwert kann zu "" werden. Bei Checkboxen und Optionsfeldern gibt .value den übermittelten Wert an, standardmäßig "on", nicht den Auswahlzustand — diesen lesen Sie mit checked aus.
Verwenden Sie für type="file" die Eigenschaft files, um auf Dateien zuzugreifen. .value gibt den tatsächlichen Pfad nicht preis; die Zuweisung einer nichtleeren Zeichenfolge löst InvalidStateError aus, während "" die Auswahl aufhebt.
Beispiele
const input = document.createElement("input");
input.type = "text";
input.defaultValue = "Ada";
input.value = "Lin";
console.log(JSON.stringify({
value: input.value,
defaultValue: input.defaultValue,
attribute: input.getAttribute("value")
}));Ergebnis
{"value":"Lin","defaultValue":"Ada","attribute":"Ada"}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.