HTMLObjectElement: validity property
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.
The validity
read-only property of the HTMLObjectElement
interface returns a ValidityState
object that represents the validity states this element is in. Although <object>
elements are never candidates for constraint validation, the validity state may still be invalid if a custom validity message has been set.
Value
A ValidityState
object.
Examples
The following example demonstrates that an <object>
is in an invalid state when a customError
is set; in this state, checkValidity()
returns true
while the validityState
's validity
property is false
.
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
Specifications
Specification |
---|
HTML Standard # dom-cva-validity |
Browser compatibility
BCD tables only load in the browser