CSSNumericValue.toSum()

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The toSum() method of the CSSNumericValue interface converts the object's value to a CSSMathSum object to values of the specified unit.

Syntax

toSum(units)

Parameters

units: The units to convert to.

Return value

A CSSNumericValue.

Exceptions

SyntaxError: undefined
TypeError: Indicates that an invalid type was passed to the method.

Examples

let v = CSS.px("23").add(CSS.percent("4")).add(CSS.cm("3")).add(CSS.in("9"));
v.toString() // => "calc(23px + 4% + 3cm + 9in)"
v.toSum("px", "percent").toString() // => "calc(1000.39px + 4%)"

Specifications

Specification
CSS Typed OM Level 2 # dom-cssnumericvalue-tosum

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`toSum`	66	79	No	No	53	No	66	66	No	47	No	9.0

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CSSNumericValue/toSum

Name	Web APIs
Version
Badge
Last Updated	2022-04-27T09:33:08Z