CSSNumericValue: to() method

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

Syntax

to(unit)

Parameters

• unit
  • : The unit to which you want to convert.

Return value

A CSSUnitValue.

Exceptions

• SyntaxError DOMException
  • : Thrown if an invalid unit was passed to the method.
• TypeError
  • : Thrown if:
    • The CSSNumericValue on which the method is being called can’t be resolved to a single value and type. This might occur if the value is calculated from a variable when the value of that variable can’t be known in the context.
    • The value can’t be converted to the new unit because it’s not of the same category. For example, you can’t convert meters to seconds.

Examples

Basic usage

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

Specifications

Browser compatibility