CSSPrimitiveValue: getRectValue() method

Deprecated

Avoid using this feature in new projects. The DOM level 2 CSS object model was excluded from the later CSS object model (CSSOM) specification. This feature may be a candidate for removal from web standards or browsers.

Consider using the following features instead: CSS object model.

Learn more
See full compatibility

Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.

The getRectValue() method of the CSSPrimitiveValue interface is used to get a rect value. If this CSS value doesn't contain a rect value, a DOMException is raised. Modification to the corresponding style property can be achieved using the Rect interface.

Note: This method was part of an attempt to create a typed CSS Object Model. This attempt has been abandoned, and most browsers do not implement it.

To achieve your purpose, you can use:

the untyped CSS Object Model, widely supported, or
the modern CSS Typed Object Model API, less supported and considered experimental.

Syntax

getRectValue()

Type	Description
`DOMException`	An `INVALID_ACCESS_ERR` is raised if the CSS value doesn't contain a Rect value. (i.e., this is not `CSS_RECT`).

Examples

const cs = window.getComputedStyle(document.getElementById("clippedDiv"));
const cssValue = cs.getPropertyCSSValue("clip");
console.log(cssValue.getRectValue());