CSSNumericValue: to() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The to() method of the CSSNumericValue interface converts a numeric value from one unit to another.

Syntax

js
to(unit)

Parameters

unit

The unit to which you want to convert.

Return value

A CSSMathSum.

Exceptions

SyntaxError DOMException

Thrown if an invalid type was passed to the method.

TypeError

Thrown if the passed values cannot be summed.

Examples

js
// Prints "0.608542cm"
console.log(CSS.px("23").to("cm").toString());

Specifications

Specification
CSS Typed OM Level 1
# dom-cssnumericvalue-to

Browser compatibility