CSSPrimitiveValue: getStringValue() method

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.

Browser compatibility