【Node.js24.x】ok::notEqual()メソッドの使い方
notEqualメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
notEqualメソッドは、Node.jsのokモジュールに属し、2つの値が厳密に等しくないことを検証するメソッドです。このメソッドは、主にプログラムのテストやデバッグの際に利用され、ある値が特定の期待値と一致しないことを確認したい場面で役立ちます。
構文はnotEqual(actual, expected[, message])であり、最初の引数actualに実際の値、2番目の引数expectedに期待される値を指定します。ここで「厳密に等しくない」とは、JavaScriptの!==演算子で比較した結果がtrueになる状態を指します。つまり、値だけでなくデータ型も完全に異なる場合にのみ、この検証は成功と見なされます。
もしactualとexpectedが厳密に等しいと判断された場合、AssertionErrorというエラーがスローされ、プログラムの実行は停止します。これは、開発者が予期しない値の一致を早期に発見し、問題のある箇所を特定するのに役立ちます。一方、actualとexpectedが厳密に等しくない場合は、何も起こらず、プログラムは正常に処理を続行します。
オプションの3番目の引数messageを指定することで、エラーが発生した際に表示されるメッセージをカスタマイズできます。このnotEqualメソッドは、プログラムの堅牢性を高め、予期せぬ動作を防ぐための重要なツールとして機能します。
構文(syntax)
1const assert = require('node:assert'); 2 3assert.ok.notEqual(1, 2);
引数(parameters)
actual, expected, message
- actual: any: 比較対象となる実際の値
- expected: any: 比較対象となる期待される値
- message: string: (オプション) アサーションが失敗した場合に表示されるエラーメッセージ
戻り値(return)
戻り値なし
戻り値はありません