ElementInternals: reportValidity() 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 reportValidity() Methode der ElementInternals Schnittstelle prüft, ob das Element alle darauf angewendeten Einschränkungsvalidierungs regeln erfüllt.

Wenn reportValidity false zurückgibt, wird ein abbrechbares ungültiges Ereignis auf dem Element ausgelöst.

Diese Methode verhält sich ähnlich wie ElementInternals.checkValidity(), allerdings wird zusätzlich der Wert von ElementInternals.validationMessage an den Benutzeragenten zur Anzeige gesendet.

Syntax

js
reportValidity()

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 nicht den Validierungsregeln entspricht. Der Aufruf von reportValidity() gibt false zurück, und der Wert "my message" wird an den Benutzeragenten zur Anzeige gesendet.

Nach erneutem Aufruf von setValidity, diesmal mit der Angabe, dass alle Regeln auf false gesetzt sind, gibt reportValidity() true zurück.

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

Spezifikationen

Specification
HTML
# dom-elementinternals-reportvalidity

Browser-Kompatibilität