files/en-us/web/api/cssprimitivevalue/getrectvalue/index.md
{{APIRef("CSSOM")}}{{deprecated_header}}
The getRectValue() method of the
{{domxref("CSSPrimitiveValue")}} interface is used to get a rect value. If this CSS
value doesn't contain a rect value, a {{domxref("DOMException")}} is raised.
Modification to the corresponding style property can be achieved using the
{{domxref("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.
getRectValue()
None.
A {{domxref("Rect")}} object representing the rect value.
| 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). |
const cs = window.getComputedStyle(document.getElementById("clippedDiv"));
const cssValue = cs.getPropertyCSSValue("clip");
console.log(cssValue.getRectValue());
This feature was originally defined in the DOM Style Level 2 specification, but has been dropped from any standardization effort since then.
It has been superseded by a modern, but incompatible, CSS Typed Object Model API that is now on the standard track.
{{Compat}}