2 つのオブジェクトが深く等しいか確認します。これは Bun の テストランナー の expect().toEqual() によって内部的に使用されます。

const a = { a: 1, b: 2, c: { d: 3 } };
const b = { a: 1, b: 2, c: { d: 3 } };

Bun.deepEquals(a, b); // true

---

厳密モードを有効にするには、第 3 引数に true を渡します。これは Bun の テストランナー の expect().toStrictEqual() によって内部的に使用されます。

以下の例は、非厳密モードでは true を返しますが、厳密モードでは false を返します。

// undefined 値
Bun.deepEquals({}, { a: undefined }, true); // false

// 配列内の undefined
Bun.deepEquals(["asdf"], ["asdf", undefined], true); // false

// スパース配列
Bun.deepEquals([, 1], [undefined, 1], true); // false

// オブジェクトリテラル vs 同じプロパティを持つインスタンス
class Foo {
  a = 1;
}
Bun.deepEquals(new Foo(), { a: 1 }, true); // false

---

さらに便利なユーティリティについては、ドキュメント > API > ユーティリティ を参照してください。