CKTIS / JavaScript
HTMLFormElement.checkValidity() — Formularvalidität prüfen
Die Methode form.checkValidity() prüft die Einschränkungen von Steuerelementen, die einem Formular zugeordnet sind, und gibt einen booleschen Wert zurück. Sie sendet das Formular nicht ab und zeigt auch keine standardmäßigen Validierungsmeldungen des Browsers an.
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
form.checkValidity()HTMLFormElement.checkValidity ist eine Web-API-Methode des Browsers und keine von ECMAScript definierte Funktion. Der Aufruf form.checkValidity() benötigt keine Argumente und gibt synchron true zurück, wenn jedes für die Validierung infrage kommende Steuerelement seine Einschränkungen erfüllt; andernfalls wird false zurückgegeben.
Geprüft werden die dem Formular zugeordneten Steuerelemente, nicht nur dessen Nachfahren. Mit disabled deaktivierte Steuerelemente werden übersprungen. Wenn kein Steuerelement für die Validierung infrage kommt, lautet das Ergebnis true. Für jedes ungültige Steuerelement löst die Methode ein invalid-Ereignis aus; wird dieses Ereignis abgebrochen, ändert sich das Ergebnis dadurch nicht zu true.
Die Methode sendet das Formular weder ab noch zeigt sie selbst die standardmäßige Fehleroberfläche an. Verwende form.reportValidity(), um Probleme zu prüfen und dem Nutzer zu melden. Die Validierung im Browser ersetzt nicht die serverseitige Validierung.
Das Beispiel erstellt ein Formular mit einem Pflicht-Textfeld. Das leere Feld ergibt false und ein invalid-Ereignis; nach der Zuweisung von Ada lautet das Ergebnis true. Führe den Code in einem Browser aus: Eine Node.js-24-Umgebung allein belegt nicht, dass diese API verfügbar ist.
Beispiele
(() => {
const form = document.createElement('form');
const input = document.createElement('input');
input.required = true;
form.append(input);
let invalidEvents = 0;
input.addEventListener('invalid', () => { invalidEvents += 1; });
console.log(form.checkValidity());
input.value = 'Ada';
console.log(form.checkValidity());
console.log(invalidEvents);
})();Ergebnis
false true 1
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.