檢查兩個對象是否深度相等。這在 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

---

傳遞 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 > Utils 獲取更多有用的工具函數。