ElementInternals: reportValidity() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2023 browserübergreifend verfügbar.
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
reportValidity()
Parameter
Keine.
Rückgabewert
Ein boolescher Wert, true, wenn das Element alle Validierungsbeschränkungen erfüllt.
Ausnahmen
NotSupportedErrorDOMException-
Wird ausgelöst, wenn das Element seine
formAssociatedEigenschaft nicht auftruegesetzt 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.
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
| Spezifikation |
|---|
| HTML # dom-elementinternals-reportvalidity |