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
# dom-cva-checkvalidity-dev

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
checkValidity

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch