HTMLFormElement: checkValidity() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since December 2018.

Die checkValidity() Methode des HTMLFormElement Interfaces gibt einen booleschen Wert zurück, der anzeigt, ob alle zugehörigen Steuerelemente alle auf sie angewendeten Einschränkungsvalidierung Regeln erfüllen. Die Methode löst auch ein invalid Ereignis für jedes ungültige Element aus, jedoch nicht für das Formularelement selbst. Da es kein Standardverhalten des Browsers für checkValidity() gibt, hat das Abbrechen dieses invalid Ereignisses keinen Effekt.

Hinweis: Die CSS-Pseudoklassen :valid und :invalid werden auf <form> Elemente basierend auf der Gültigkeit der dazugehörigen Formularelemente angewendet, nicht auf die Gültigkeit des <form> Elements selbst.

Syntax

js
checkValidity()

Parameter

Keine.

Rückgabewert

Gibt true zurück, wenn die Werte der zugehörigen Steuerelemente keine Gültigkeitsprobleme aufweisen; andernfalls wird false zurückgegeben.

Beispiele

Im folgenden Beispiel würde der Aufruf von checkValidity() true oder false zurückgeben.

js
const element = document.getElementById("myForm");
console.log(element.checkValidity());

Spezifikationen

Specification
HTML Standard
# dom-form-checkvalidity-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch