HTMLObjectElement: validity Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since December 2018.

Die schreibgeschützte validity-Eigenschaft der HTMLObjectElement Schnittstelle gibt ein ValidityState Objekt zurück, das die Gültigkeitszustände dieses Elements repräsentiert. Obwohl <object>-Elemente niemals Kandidaten für die Einschränkungsvalidierung sind, kann der Gültigkeitszustand dennoch ungültig sein, wenn eine benutzerdefinierte Fehlermeldung festgelegt wurde.

Wert

Ein ValidityState Objekt.

Beispiele

Das folgende Beispiel zeigt, dass ein <object> in einem ungültigen Zustand ist, wenn ein customError gesetzt ist; in diesem Zustand gibt checkValidity() true zurück, während die validity-Eigenschaft des validityState false ist.

js
const objectElem = document.getElementById("myObjectElm");
objectElem.setCustomValidity("This object element is invalid.");
const validityState = objectElem.validity;
console.log(validityState.valid); // false
console.log(validityState.customError); // true
console.log(objectElem.checkValidity()); // true

Spezifikationen

Specification
HTML Standard
# dom-cva-validity

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch