WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Formulare und Gültigkeitsprüfung

Mit `input` reagierst du auf Änderungen an einem Feld. Mit `submit` behandelst du den Versand eines Formulars nach erfolgreicher Standardvalidierung. `HTMLFormElement` bietet außerdem Methoden, um die Gültigkeit eines Formulars gezielt zu prüfen.

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

field.addEventListener("input", handler); form.addEventListener("submit", handler); form.checkValidity(); form.reportValidity(); form.requestSubmit();

HTMLFormElement ist die DOM-Schnittstelle des Browsers für ein form-Element. Über die Eigenschaft form.elements greifst du auf die Steuerelemente zu, die zum Formular gehören. Diese Schnittstelle ist eine Web-API und kein Teil der Sprache ECMAScript.

Mit dem Ereignis input reagierst du auf Benutzereingaben, etwa um beim Tippen einen Hinweis zu aktualisieren. Wenn du field.value in JavaScript einen Wert zuweist, löst das allein kein input aus. Das Attribut required macht ein leeres Textfeld ungültig. form.checkValidity() gibt das Prüfergebnis als booleschen Wert zurück. Auch form.reportValidity() gibt einen booleschen Wert zurück und zeigt zusätzlich Validierungsfehler an, sofern das invalid-Ereignis des betroffenen Steuerelements nicht abgebrochen wird. Wird dieses Ereignis abgebrochen, bleibt das Prüfergebnis unverändert: Die Methode gibt false zurück, ohne für dieses Steuerelement einen Fehler anzuzeigen.

Bei einem gewöhnlichen Sendeversuch prüft der Browser zuerst die Gültigkeitsbedingungen. Ist ein Feld ungültig, blockiert er den Versand, und es wird kein submit-Ereignis ausgelöst. Ist die Prüfung erfolgreich, wird submit auf dem Formular ausgelöst, nicht auf der Schaltfläche. Ein Aufruf von event.preventDefault() in der Ereignisbehandlung verhindert den standardmäßigen Versand.

Mit form.requestSubmit() startest du denselben Ablauf aus dem Code. Ein direkter Aufruf von form.submit() überspringt sowohl die Validierung als auch das Ereignis submit. Die Validierung im Browser hilft dabei, Eingaben zu korrigieren, ersetzt aber nicht die serverseitige Validierung.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>Form validity</title>
<form id="profile">
  <label>Name <input name="displayName" required></label>
  <button type="submit">Save</button>
</form>
<pre id="log"></pre>
<script>
  const form = document.querySelector('#profile');
  const field = form.elements.namedItem('displayName');
  const log = document.querySelector('#log');
  const append = (line) => { log.textContent += line + '\n'; };

  field.addEventListener('input', () => {
    append(`input: ${form.checkValidity()}`);
  });
  form.addEventListener('submit', (event) => {
    event.preventDefault();
    append(`submit: ${field.value}`);
  });

  append(`initial: ${form.checkValidity()}`);
</script>

Ergebnis

initial: false
input: true
submit: A

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