Web/API/CSSNumericValue/equals

Draft This page is not complete.

This is an experimental technologyCheck the Browser compatibility table carefully before using this in production.

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

var boolean = CSSNumericValue.equals(number);

Parameters

number

Either a Number or a CSSNumericValue.

Return value

A Boolean.

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.

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	Status	Comment
CSS Typed OM Level 1The definition of 'equals' in that specification.	Working Draft	Initial definition.

Browser compatibility

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
equals Experimental'	Chrome Full support 66	Edge Full support 79	Firefox No support No	IE No support No	Opera Full support 53	Safari No support No	WebView Android Full support 66	Chrome Android Full support 66	Firefox Android No support No	Opera Android Full support 47	Safari iOS No support No	Samsung Internet Android Full support 9.0

Legend

Full support  

Full support

No support  

No support

Experimental. Expect behavior to change in the future.'

Experimental. Expect behavior to change in the future.

CSSNumericValue.equals() by Mozilla Contributors is licensed under CC-BY-SA 2.5.