WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

ValidityState.valid — zusammengefasster Gültigkeitsstatus eines Steuerelements

ValidityState.valid ist eine schreibgeschützte boolesche Eigenschaft: Sie ist true, wenn keine der Validierungsfehler-Flags des Steuerelements 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

element.validity.valid

ValidityState.valid, abrufbar als element.validity.valid, ist true, wenn alle anderen Fehler-Flags in ValidityState den Wert false haben. Dies ist eine Browser-API, die im HTML Standard definiert ist, und kein Feature einer bestimmten ECMAScript-Version.

Das Objekt validity wird laufend aktualisiert. Im Beispiel ist das leere Pflichtfeld ungültig; durch die Eingabe von Ada wird der Fehler wegen des fehlenden Werts beseitigt. Eine nicht leere Nachricht in setCustomValidity() setzt einen benutzerdefinierten Fehler; setCustomValidity('') entfernt ihn.

Das Lesen von valid zeigt weder eine Meldung an noch löst es invalid aus. Es bedeutet auch nicht, dass das Steuerelement an der Validierung teilnimmt: willValidate gibt an, ob es dafür infrage kommt. checkValidity() berücksichtigt diese Teilnahmeberechtigung, während reportValidity() das Problem zusätzlich anzeigen kann.

Beispiele

const input = document.createElement('input');
input.required = true;
const state = input.validity;
console.log(state.valid);
input.value = 'Ada';
console.log(state.valid);
input.setCustomValidity('Rejected');
console.log(state.valid);
input.setCustomValidity('');
console.log(state.valid);

Ergebnis

false
true
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.

Quellen