ElementInternals: checkValidity()-Methode

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die checkValidity()-Methode der ElementInternals-Schnittstelle überprüft, ob das Element die auf es angewendeten Einschränkungsvalidierungsregeln erfüllt.

Gibt checkValidity false zurück, wird ein stornierbares ungültiges Ereignis auf dem Element ausgelöst.

Syntax

js
checkValidity()

Parameter

Keine.

Rückgabewert

Ein boolescher Wert, true wenn das Element alle Validierungsbeschränkungen erfüllt.

Ausnahmen

NotSupportedError DOMException

Ausgelöst, wenn das Element seine formAssociated-Eigenschaft nicht auf true gesetzt hat.

Beispiele

Im folgenden Beispiel wird ElementInternals.setValidity() verwendet, um anzuzeigen, dass das Element die Validierungsregeln nicht erfüllt. Ein Aufruf von checkValidity() gibt false zurück. Nach erneutem Aufruf von setValidity, diesmal um anzuzeigen, dass alle Regeln auf false gesetzt sind, gibt checkValidity() true zurück.

js
let element = document.getElementById("join-checkbox");
element.internals_.setValidity({ valueMissing: true }, "my message");
console.log(element.internals_.checkValidity()); // false
element.internals_.setValidity({});
console.log(element.internals_.checkValidity()); // true

Spezifikationen

Specification
HTML Standard
# dom-elementinternals-checkvalidity

Browser-Kompatibilität

BCD tables only load in the browser