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 angibt, ob alle zugehörigen Steuerelemente die auf sie angewendeten Einschränkungsvalidierungs-Regeln erfüllen. Die Methode löst auch ein invalid-Ereignis bei jedem ungültigen Element aus, aber nicht beim Formularelement selbst. Da es kein Standard-Browserverhalten für checkValidity() gibt, hat das Abbrechen dieses invalid-Ereignisses keine Auswirkungen.

Hinweis: Die CSS-Pseudoklassen :valid und :invalid werden auf <form>-Elemente basierend auf der Gültigkeit ihrer zugehö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
# dom-form-checkvalidity-dev

Browser-Kompatibilität

Siehe auch