files/en-us/web/api/cssprimitivevalue/getstringvalue/index.md
{{APIRef("CSSOM")}}{{deprecated_header}}
The getStringValue() method of the
{{domxref("CSSPrimitiveValue")}} interface is used to get a string value. If this CSS
value doesn't contain a string value, a {{domxref("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.
getStringValue()
None.
A string value.
| Type | Description |
|---|---|
DOMException | An INVALID_ACCESS_ERR is raised if the CSS value doesn't contain a string value. |
const cs = window.getComputedStyle(document.body);
const cssValue = cs.getPropertyCSSValue("display");
console.log(cssValue.getStringValue());
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}}