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 CSSUnitValue.
Exceptions
SyntaxErrorDOMException-
Thrown if an invalid unit was passed to the method.
TypeError-
Thrown if:
- The
CSSNumericValueon 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.
- The
Examples
Basic usage
js
// Prints "0.608542cm"
console.log(CSS.px("23").to("cm").toString());
Specifications
| Specification |
|---|
| CSS Typed OM Level 1 # dom-cssnumericvalue-to |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
to
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- See implementation notes.
- User must explicitly enable this feature.