CSSPrimitiveValue: getStringValue() 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.
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 getStringValue() method of the
CSSPrimitiveValue interface is used to get a string value. If this CSS
value doesn't contain a string value, a DOMException is raised.
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
getStringValue()
Parameters
None.
Return value
A string value.
Exceptions
| Type | Description |
|---|---|
DOMException |
An INVALID_ACCESS_ERR is raised if the CSS value doesn't contain a string value. |
Examples
const cs = window.getComputedStyle(document.body);
const cssValue = cs.getPropertyCSSValue("display");
console.log(cssValue.getStringValue());
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.