CSSMathMax: CSSMathMax() constructor

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

Note: This feature is available in Web Workers.

The CSSMathMax() constructor creates a new CSSMathMax object which represents the CSS max() function.

Syntax

js
new CSSMathMax(arg1)
new CSSMathMax(arg1, arg2)
new CSSMathMax(arg1, arg2, /* …, */ argN)

Parameters

arg1, …, argN

A list of numbers or CSSNumericValue objects.

Exceptions

SyntaxError DOMException

Thrown if no arguments are passed.

TypeError

Thrown if arg1, …, argN have incompatible types (for example, mixing a <length> with an <angle>), so a common type cannot be determined for comparison.

Examples

undefined

Basic usage

The following code creates a CSSMathMax instance from three values, then reads back its operator and values properties.

js
const max = new CSSMathMax(CSS.px(10), CSS.em(5), CSS.percent(50));

console.log(max.constructor.name); // "CSSMathMax"
console.log(max.operator); // 'max'
console.log(max.values); // CSSNumericArray {0: CSSUnitValue, 1: CSSUnitValue, 2: CSSUnitValue, length: 3}
console.log(max.values[0]); // CSSUnitValue {value: 10, unit: "px"}

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.

js
try {
  // Mixes a length (px) with a time (s): incompatible types
  new CSSMathMax(CSS.px(10), CSS.s(2));
} catch (e) {
  console.log(e instanceof TypeError); // true
  console.log(e.message);
}

Empty arguments

The constructor throws a SyntaxError if called with no arguments.

js
try {
  new CSSMathMax();
} catch (e) {
  console.log(e instanceof DOMException); // true
  console.log(e.name); // "SyntaxError"
}

Specifications