CSSMathSum: CSSMathSum() constructor
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("CSS Typed Object Model API")}}{{AvailableInWorkers}}{{SeeCompatTable}}
The **CSSMathSum()** constructor creates a new {{domxref("CSSMathSum")}} object representing the sum of the arguments passed into it.
Numeric arguments are wrapped into {{domxref("CSSUnitValue")}} objects with a unit of "number". All arguments are stored as separate items in its {{domxref("CSSMathSum/values","values")}} property.
Syntax
new CSSMathSum(arg1)
new CSSMathSum(arg1, arg2)
new CSSMathSum(arg1, arg2, /* …, */ argN)Parameters
arg1, …,argN- : One or more numbers or {{domxref("CSSNumericValue")}} objects.
Exceptions
SyntaxError{{domxref("DOMException")}}- : Thrown if no arguments are passed.
- {{jsxref("TypeError")}}
- : Thrown if
arg1, …,argNhave incompatible types.
Examples
Basic usage
The following code creates a CSSMathSum instance from three values, then reads back its operator and values properties.
const sum = new CSSMathSum(CSS.px(10), CSS.em(5), CSS.percent(50));
console.log(sum.constructor.name); // "CSSMathSum"
console.log(sum.operator); // 'sum'
console.log(sum.values); // CSSNumericArray {0: CSSUnitValue, 1: CSSUnitValue, 2: CSSUnitValue, length: 3}
console.log(sum.values[0]); // CSSUnitValue {value: 10, unit: "px"}Empty arguments
The constructor throws a SyntaxError if called with no arguments.
try {
new CSSMathSum();
} catch (e) {
console.log(e instanceof DOMException); // true
console.log(e.name); // "SyntaxError"
}Handling incompatible types
The constructor throws a TypeError if the values don't resolve to a compatible type. In the following code we mix a length with a time, and log the error.
try {
// Mixes a length (px) with a time (s): incompatible types
new CSSMathSum(CSS.px(10), CSS.s(2));
} catch (e) {
console.log(e instanceof TypeError); // true
console.log(e.message);
}Specifications
{{Specifications}}
Browser compatibility
{{Compat}}