CKTIS / JavaScript
HTMLInputElement.checkValidity() — Gültigkeit eines Eingabefelds prüfen
Die Methode checkValidity() prüft die Einschränkungen eines einzelnen Eingabefelds und gibt einen booleschen Wert zurück. Bei einem ungültigen Feld, das an der Validierung teilnimmt, löst sie das Ereignis invalid aus, zeigt aber selbst keine Fehlermeldung 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
input.checkValidity()HTMLInputElement.checkValidity ist eine Instanzmethode, die ohne Argumente als input.checkValidity() aufgerufen wird. Sie gibt false zurück, wenn das Eingabefeld an der Validierung teilnimmt und seine Einschränkungen verletzt; andernfalls gibt sie true zurück.
Die Einschränkungen hängen vom Feldtyp und Attributen wie required, pattern, min und max ab. Ein disabled-Feld nimmt nicht an der Validierung teil: true bedeutet daher nicht unbedingt, dass sein Wert gültig ist. Die Eigenschaft willValidate zeigt an, ob das Feld teilnimmt.
Bei einem Ergebnis von false löst die Methode ein invalid-Ereignis aus; dessen Abbruch ändert das Ergebnis nicht. Anders als reportValidity() zeigt sie keine Fehlermeldung an. Sie sendet weder das Formular ab noch prüft sie weitere Felder.
Diese Browser-API ist im HTML Living Standard festgelegt, nicht in ECMAScript. Sie wird von aktuellen Browser-Engines unterstützt; dass sich Node 24 in einem Repository befindet, belegt nicht die Unterstützung dieser API.
Beispiele
const input = document.createElement('input');
input.type = 'text';
input.required = true;
let invalidEvents = 0;
input.addEventListener('invalid', () => { invalidEvents += 1; });
console.log(input.checkValidity());
input.value = 'Ada';
console.log(input.checkValidity());
input.value = '';
input.disabled = true;
console.log(input.checkValidity());
console.log(invalidEvents);Ergebnis
false true 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.