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

throwsメソッドは、引数として渡された関数が実行時に例外（エラー）をスローするかどうかをテストするために使用するメソッドです。

このメソッドの主な目的は、開発中のプログラムが特定の条件下で意図通りにエラーを発生させることを確認することにあります。例えば、不正な入力値が与えられた場合にエラーを投げるべき関数や、予期せぬ状況で例外処理が正しく機能すべきコードの検証に役立ちます。

具体的には、throwsメソッドにテストしたい関数を渡して実行します。もしその関数が例外をスローした場合、throwsメソッドはテストが成功したと判断します。さらに、スローされる例外の種類やメッセージ内容を詳細に検証したい場合には、オプションとして正規表現、特定のエラー型、またはエラーオブジェクトを引数として指定することも可能です。これにより、期待する形式のエラーが確実に発生しているかを確認できます。

もし関数が例外をスローしなかった場合、またはスローされた例外が指定した条件に合致しなかった場合、throwsメソッドはアサーションエラーとしてテストの失敗を報告します。

システム開発において、堅牢で信頼性の高いアプリケーションを構築するためには、エラーハンドリングの検証が非常に重要です。このthrowsメソッドは、プログラムの安定性を確保し、潜在的なバグを発見するための強力なツールとして活用されます。

Copy
1import { ok } from 'node:assert';
2
3function functionThatThrows() {
4  throw new Error('An error occurred.');
5}
6
7ok.throws(functionThatThrows, Error); // functionThatThrowsがError型の例外をスローすることを確認

promiseFn, ...args

• promiseFn: Promiseを返す関数
• ...args: promiseFnに渡す追加の引数

戻り値なし

戻り値はありません