CKTIS / JavaScript
HTMLInputElement.validity — Gültigkeitsstatus eines Eingabefelds
HTMLInputElement.validity stellt den aktuellen Zustand der Einschränkungsvalidierung eines Eingabefelds als ValidityState-Objekt bereit. Seine Flags kennzeichnen bestimmte Probleme; valid zeigt an, ob kein Fehler-Flag gesetzt ist.
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.validity
input.validity.valid
input.validity.valueMissingHTMLInputElement.validity ist eine schreibgeschützte Eigenschaft, die ein dynamisches ValidityState-Objekt zurückgibt: Eine gespeicherte Referenz spiegelt spätere Änderungen am Eingabefeld wider. Auch seine Flags sind schreibgeschützt. Diese Browser-API ist in HTML definiert, nicht in ECMAScript; die Verfügbarkeit von Node.js allein bedeutet nicht, dass sie unterstützt wird.
valueMissing weist auf einen fehlenden Pflichtwert hin, typeMismatch auf ein nicht zum Typ passendes Format und patternMismatch auf eine Abweichung von pattern. Die weiteren Fehler-Flags sind tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput und customError. Ob sie anwendbar sind, hängt vom Eingabetyp und den Einschränkungen ab. valid ist true, wenn alle Fehler-Flags false sind.
Das Auslesen von validity zeigt weder eine Meldung an noch löst es invalid aus. checkValidity() prüft das Steuerelement und kann invalid auslösen; reportValidity() kann das Problem zusätzlich dem Nutzer anzeigen. willValidate legt fest, ob das Element an der Validierung teilnimmt: Ein deaktiviertes Eingabefeld kann weiterhin Fehler-Flags haben, obwohl es nicht an der Prüfung teilnimmt.
setCustomValidity('Blocked') setzt customError; mit setCustomValidity('') lässt sich der Fehler löschen. Den Wert zu korrigieren, löscht den Fehler allein nicht. Das Beispiel zeigt Änderungen über das gespeicherte Objekt state, ohne input.validity erneut auszulesen. Die Browservalidierung ersetzt keine serverseitige Datenprüfung.
Beispiele
const input = document.createElement('input');
input.type = 'email';
input.required = true;
const state = input.validity;
console.log(state.valueMissing, state.valid);
input.value = 'learner@example.com';
console.log(state.valueMissing, state.valid);
input.setCustomValidity('Blocked');
console.log(state.customError, state.valid);
input.setCustomValidity('');
console.log(state.customError, state.valid);Ergebnis
true false false true true false false 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.