WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen