WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ValidityState — Validierungsstatus eines Formularfelds

ValidityState stellt schreibgeschützte Fehlerflags für ein Formularfeld bereit. Damit lassen sich ein fehlender Pflichtwert, ein ungültiges Format und ein zu kurzer Text unterscheiden – mit einer wichtigen Ausnahme für Werte, die von Skripten gesetzt werden.

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

const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;

ValidityState ist eine Schnittstelle der HTML Web API und kein Teil von ECMAScript. Das über input.validity verfügbare Objekt wird laufend aktualisiert; seine booleschen Flags sind schreibgeschützt. ValidityState.valid ist true, wenn keines der anderen Fehlerflags gesetzt ist.

ValidityState.valueMissing signalisiert, dass die Einschränkung required nicht erfüllt ist: Bei einem Textfeld bedeutet das, dass der Wert leer ist. ValidityState.typeMismatch bedeutet, dass ein Wert gegen die Regeln des Typs email oder url verstößt, nicht gegen einen JavaScript-Datentyp. Eine leere E-Mail-Adresse verursacht diesen Fehler nicht von selbst.

ValidityState.tooShort gilt für einen nicht leeren Wert, der in einem Feld mit entsprechender Unterstützung kürzer als minlength ist. Dafür müssen das Dirty-Value-Flag gesetzt und die letzte Wertänderung eine Benutzereingabe gewesen sein. Eine Zuweisung an .value löst diese Längenprüfung nicht aus; minlength allein macht einen Wert nicht erforderlich.

Das Beispiel behält dasselbe Zustandsobjekt bei und liest es nach Änderungen aus. Bei 'x' bleibt tooShort auf false, weil ein Skript den Wert setzt. Führe es in einem Browser aus; dass Node 24 im Repository vorhanden ist, belegt keine Unterstützung für diese API.

Beispiele

(() => {
  const input = document.createElement('input');
  input.type = 'email';
  input.required = true;
  input.minLength = 8;
  const state = input.validity;

  const show = () => console.log(JSON.stringify({
    valid: state.valid,
    valueMissing: state.valueMissing,
    typeMismatch: state.typeMismatch,
    tooShort: state.tooShort
  }));

  show();
  input.value = 'x';
  show();
  input.value = 'a@example.com';
  show();
})();

Ergebnis

{"valid":false,"valueMissing":true,"typeMismatch":false,"tooShort":false}
{"valid":false,"valueMissing":false,"typeMismatch":true,"tooShort":false}
{"valid":true,"valueMissing":false,"typeMismatch":false,"tooShort":false}

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