CSSStyleValue: toString() method

Note: This feature is available in Web Workers.

The toString() method of the CSSStyleValue interface is a stringifier that returns the value formatted as a string of standard CSS text.

Syntax

js
toString()

Parameters

None.

Return value

A string.

Description

The exact serialization of the object to a string depends on how the CSSStyleValue object was obtained:

For more information about serialization rules see When and how values are serialized in CSS value serialization.

Examples

undefined

Basic usage

js
// Parsed from a string: returns the original string
const length1 = CSSStyleValue.parse("42.0px");
length1.toString(); // "42.0px"

// Constructed directly with a CSS factory function: subclass-specific serialization
const length2 = CSS.px(42.0);
length2.toString(); // "42px"

// Read from the CSSOM: follows CSSOM serialization rules
const element = document.createElement("div");
element.style.width = "42.0px";
const length3 = element.attributeStyleMap.get("width");
length3.toString(); // "42px"

Specifications

See also