mirror of
https://github.com/oven-sh/bun
synced 2026-02-02 15:08:46 +00:00
42 lines
1.1 KiB
Plaintext
42 lines
1.1 KiB
Plaintext
---
|
|
title: Check if two objects are deeply equal
|
|
sidebarTitle: Deep equality
|
|
mode: center
|
|
---
|
|
|
|
Check if two objects are deeply equal. This is used internally by `expect().toEqual()` in Bun's [test runner](/test/writing-tests).
|
|
|
|
```ts index.ts icon="/icons/typescript.svg"
|
|
const a = { a: 1, b: 2, c: { d: 3 } };
|
|
const b = { a: 1, b: 2, c: { d: 3 } };
|
|
|
|
Bun.deepEquals(a, b); // true
|
|
```
|
|
|
|
---
|
|
|
|
Pass `true` as a third argument to enable strict mode. This is used internally by `expect().toStrictEqual()` in Bun's [test runner](/test/writing-tests).
|
|
|
|
The following examples would return `true` in non-strict mode but `false` in strict mode.
|
|
|
|
```ts index.ts icon="/icons/typescript.svg"
|
|
// undefined values
|
|
Bun.deepEquals({}, { a: undefined }, true); // false
|
|
|
|
// undefined in arrays
|
|
Bun.deepEquals(["asdf"], ["asdf", undefined], true); // false
|
|
|
|
// sparse arrays
|
|
Bun.deepEquals([, 1], [undefined, 1], true); // false
|
|
|
|
// object literals vs instances w/ same properties
|
|
class Foo {
|
|
a = 1;
|
|
}
|
|
Bun.deepEquals(new Foo(), { a: 1 }, true); // false
|
|
```
|
|
|
|
---
|
|
|
|
See [Docs > API > Utils](/runtime/utils) for more useful utilities.
|