WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen