Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Node.js24.x】ok::deepStrictEqual()メソッドの使い方

deepStrictEqualメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

deepStrictEqualメソッドは、Node.jsのテストにおいて、二つの値が厳密に等しいかどうかを深く検証するために使用されるメソッドです。このメソッドは、単純なプリミティブ値だけでなく、オブジェクトや配列といった複合データ構造に対しても、その内容を再帰的に比較する機能を持っています。

具体的には、比較対象となる両方の値が、同じ型であり、同じプロパティを持ち、各プロパティの値もまた厳密に等しい場合にのみ「等しい」と判断されます。オブジェクトの比較においては、プロパティの順序も考慮され、例えば二つのオブジェクトのプロパティが同じでも、その定義順序が異なると、「等しくない」と判断される場合があります。もし二つの値が厳密に等しくないと判断された場合、このメソッドはAssertionErrorを発生させ、テストの失敗を示します。

システムエンジニアを目指す初心者の方々にとって、このdeepStrictEqualメソッドは、開発したプログラムの機能が意図通りに動作しているかを検証するユニットテストや統合テストにおいて非常に重要な役割を果たします。特に、複雑なデータ構造を扱うアプリケーションでは、期待される出力と実際の結果が完全に一致しているかを確実にするために、===演算子だけでは不十分な場合が多く、この深い比較機能が不可欠となります。これにより、コードの品質と信頼性を高めることができます。

構文(syntax)

1const assert = require('assert');
2
3const actual = { a: 1, b: [2, { c: 3 }] };
4const expected = { a: 1, b: [2, { c: 3 }] };
5
6assert.deepStrictEqual(actual, expected, 'actual と expected の値は厳密に等しい必要があります。');

引数(parameters)

actual, expected, message

  • actual: any: 比較対象となる実際の値
  • expected: any: 比較対象となる期待される値
  • message: string: エラー発生時に表示されるメッセージ

戻り値(return)

戻り値なし

戻り値はありません

関連コンテンツ