ElementInternals: reportValidity() Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2023.
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
| Specification |
|---|
| HTML # dom-elementinternals-reportvalidity |
Browser-Kompatibilität
Loading…