equals

function equals(a: unknown, b: unknown): boolean;

Объекты и массивы обходятся по ключам, даты сравниваются по моменту времени, примитивы — по SameValueZero, поэтому NaN равен NaN, чего === никогда не даёт. Если у значения есть собственный метод equals, спрашивают его, а не разбирают значение по частям.

Циклы допустимы: структура, ссылающаяся на себя, сравнивается без зацикливания.

Параметры

Параметр	Тип	Описание
`a`	`unknown`	Первое значение.
`b`	`unknown`	Второе значение.

Возвращает

boolean — true, если значения равны на всю глубину.

Примеры

Сравнение

equals({ a: 1 }, { a: 1 }); // => true
equals([1, { a: 2 }], [1, { a: 2 }]); // => true
equals(NaN, NaN); // => true
equals(new Date(0), new Date(0)); // => true

Смотрите также

Исходный код

src/lang/object/equals.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.