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 alle darauf angewendeten Constraint-Validierung Regeln erfüllt.

Wenn checkValidity false zurückgibt, wird ein abbrechbares 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

Wird 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. Beim Aufruf von checkValidity() wird false zurückgegeben. Nach einem erneuten Aufruf von setValidity, diesmal mit der Angabe, dass alle Regeln falsch markiert 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
# dom-elementinternals-checkvalidity

Browser-Kompatibilität