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.


var rectValue = cssPrimitiveValue.getRectValue();

Return value

A 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).


var cs = window.getComputedStyle(document.getElementById("clippedDiv"));
var cssValue = cs.getPropertyCSSValue("clip");


Specification Status Comment
Document Object Model (DOM) Level 2 Style Specification
The definition of 'CSSPrimitiveValue.getRectValue' in that specification.
Obsolete Initial definition

Browser compatibility

Update compatibility data on GitHub
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic support
Chrome No support NoEdge ? Firefox No support ? — 62IE ? Opera No support NoSafari ? WebView Android ? Chrome Android ? Edge Mobile ? Firefox Android No support ? — 62Opera Android ? Safari iOS ? Samsung Internet Android ?


No support  
No support
Compatibility unknown  
Compatibility unknown
Deprecated. Not for use in new websites.
Deprecated. Not for use in new websites.

Document Tags and Contributors

Contributors to this page: fscholz, Sebastianz
Last updated by: fscholz,