API reference › @evolu/common › Assert › assertEqual

function assertEqual(actual: unknown, expected: unknown): void;

Defined in: packages/common/src/Assert.ts:1091

Asserts that two values are equal.

Use this for value comparisons of both primitive and deeply structured values. Use assertSame when exact sameness or narrowing is required.

Like assert.deepEqual from node:assert/strict, it performs deep structural comparison, but uses deliberately smaller, platform-agnostic equality logic based on eqData. More complex comparison logic is difficult to reason about and rarely needed. Other values are opaque and compare equal only by identity. If broader comparison semantics are needed in Node.js, use the native assertion instead.

Example

import { assertEqual } from "@evolu/common";

assertEqual(21 * 2, 42);

const actual: unknown = new Map([["roles", new Set(["admin", "author"])]]);
const expected = new Map([["roles", new Set(["author", "admin"])]]);

assertEqual(actual, expected);