HTMLButtonElement: 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 HTMLButtonElement-Interfaces gibt einen booleschen Wert zurück, der angibt, ob das Element den darauf angewendeten Einschränkungsvalidierungsregeln entspricht. Wenn der Wert false ist, löst die Methode auch ein invalid-Ereignis auf dem Element aus. Da es kein Standardverhalten des Browsers für checkValidity() gibt, hat das Abbrechen dieses invalid-Ereignisses keine Wirkung. Es gibt immer true zurück, wenn der type des <button>-Elements "button" oder "reset" ist, da solche Schaltflächen nie Kandidaten für die Einschränkungsvalidierung sind.

Hinweis: Ein HTML-<button>-Element vom Typ "submit" mit einer nicht-nullen validationMessage gilt als ungültig, wird die CSS-:invalid-Pseudo-Klasse erfüllen und checkValidity() wird false zurückgeben. Verwenden Sie die HTMLButtonElement.setCustomValidity()-Methode, um die HTMLButtonElement.validationMessage auf einen leeren String zu setzen, um den validity-Zustand als gültig zu setzen.

Syntax

js
checkValidity()

Parameter

Keine.

Rückgabewert

Gibt true zurück, wenn der Wert des Elements keine Validitätsprobleme aufweist; andernfalls wird false zurückgegeben.

Beispiele

Im folgenden Beispiel gibt der Aufruf von checkValidity() entweder true oder false zurück.

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

Spezifikationen

Specification
HTML Standard
# dom-cva-checkvalidity-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch