CKTIS / JavaScript
HTMLFormElement.reportValidity() — Formular prüfen und Fehler melden
HTMLFormElement.reportValidity() prüft die Validierungsbedingungen der mit einem Formular verknüpften Steuerelemente und kann Fehler für den Nutzer melden. Die Methode gibt einen Boolean zurück und sendet das Formular nicht selbst ab.
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.reportValidity()HTMLFormElement.reportValidity ist eine Methode der Formularschnittstelle, die im HTML Living Standard und nicht in ECMAScript definiert ist. form.reportValidity() benötigt keine Argumente und gibt synchron true zurück, wenn alle validierbaren Steuerelemente gültig sind, andernfalls false.
Die Methode führt eine interaktive Einschränkungsvalidierung für Bedingungen wie required aus. Bei ungültigen Steuerelementen werden invalid-Ereignisse ausgelöst. Der Browser kann Fehler melden, deren Behandlung nicht abgebrochen wurde; Aussehen und Wortlaut der Meldungen hängen vom Browser ab. event.preventDefault() in einem invalid-Handler unterdrückt die native Meldung für diesen Fehler, ändert aber nicht das Ergebnis false.
Anders als reportValidity() prüft checkValidity() die Bedingungen ohne interaktive Fehlermeldung, löst aber ebenfalls invalid aus. Keine der beiden Methoden sendet das Formular ab. Mit disabled deaktivierte Steuerelemente werden nicht validiert; die clientseitige Validierung ersetzt keine Datenprüfung auf dem Server.
Dies ist eine Browser-API: Dass Node 24 vorhanden ist, belegt nicht ihre Verfügbarkeit. Prüfe in der Zielumgebung typeof HTMLFormElement !== 'undefined' && typeof HTMLFormElement.prototype.reportValidity === 'function'. Das Beispiel bricht invalid absichtlich ab, damit sich die Boolean-Ergebnisse ohne Abhängigkeit von der Meldungsoberfläche prüfen lassen.
Beispiele
(() => {
const form = document.createElement('form');
const input = document.createElement('input');
input.required = true;
input.setAttribute('aria-label', 'Name');
form.append(input);
document.body.append(form);
// Suppress native validation UI for deterministic console checks.
input.addEventListener('invalid', event => event.preventDefault());
console.log(form.reportValidity());
input.value = 'Ada';
console.log(form.reportValidity());
form.remove();
})();Ergebnis
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.