CSSNumericValue: equals() method
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
The equals() method of the
CSSNumericValue interface returns a boolean indicating whether the passed
value are strictly equal. To return a value of true, all passed values must
be of the same type and value and must be in the same order. This allows structural
equality to be tested quickly.
Syntax
js
equals(number)
Parameters
number-
Either a number or a
CSSNumericValue.
Return value
A boolean value.
Exceptions
None.
Examples
As stated earlier, all passed values must be of the same type and value and must be in the same order. Some of the following examples illustrate what happens when they are not.
js
let cssMathSum = new CSSMathSum(CSS.px(1), CSS.px(2));
let matchingCssMathSum = new CSSMathSum(CSS.px(1), CSS.px(2));
// Prints true
console.log(cssMathSum.equals(matchingCssMathSum));
let otherCssMathSum = CSSMathSum(CSS.px(2), CSS.px(1));
// Prints false
console.log(cssMathSum.equals(otherCssMathSum));
// Also prints false
console.log(CSS.cm("1").equal(CSS.in("0.393701")));
Specifications
| Specification |
|---|
| CSS Typed OM Level 1 # dom-cssnumericvalue-equals |
Browser compatibility
BCD tables only load in the browser