web api instance method
CSSPrimitiveValue: getRGBColorValue() method
The getRGBColorValue() method of the
CSSPrimitiveValue interface is used to get an RGB color value. If this
CSS value doesn’t contain a RGB color value, a DOMException is raised.
Modification to the corresponding style property can be achieved using the
RGBColor 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
getRGBColorValue()
Parameters
None.
Return value
An RGBColor object representing the color value.
Exceptions
| Type | Description |
|---|---|
DOMException | An INVALID_ACCESS_ERR is raised if the attached property can’t return an RGB color value (i.e., this is not CSS_RGBCOLOR). |
Examples
const cs = window.getComputedStyle(document.body);
const cssValue = cs.getPropertyCSSValue("color");
console.log(cssValue.getRGBColorValue());
Specifications
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.