HTMLFormElement: Methode checkValidity()

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 angibt, ob alle zugehörigen Steuerelemente alle darauf angewendeten Einschränkungsvalidierungsregeln erfüllen. Die Methode löst auch ein invalid-Ereignis bei jedem ungültigen Element aus, jedoch nicht beim Formular-Element selbst. Da es kein standardmäßiges Browser-Verhalten für checkValidity() gibt, hat das Abbrechen dieses invalid-Ereignisses keine Auswirkungen.

Hinweis: Die :valid- und :invalid-CSS-Pseudoklassen werden auf <form>-Elemente basierend auf der Gültigkeit der zugehörigen Formularsteuerelemente 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