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

doesNotMatchメソッドは、与えられた文字列が特定の正規表現パターンに一致しないことを検証するメソッドです。主にテストコード内で利用され、プログラムが出力するメッセージやデータ、または変数に格納された値などが、予期せぬパターンを含んでいないことを確認する際に役立ちます。

このメソッドは、検証したい対象の文字列と、マッチしてはいけない正規表現パターンを引数として受け取ります。例えば、アプリケーションのエラーログに機密情報が含まれていないかを確認したり、ユーザーが入力したデータが禁止されている文字列パターンを含んでいないかを検証したりする場面で活用できます。

もし、渡された文字列が指定された正規表現パターンに一致してしまった場合、このメソッドはAssertionErrorをスローし、そのアサーションが失敗したことを明確に示します。文字列が正規表現パターンに一致しなかった場合は、何もエラーを発生させずに処理が続行されます。

doesNotMatchメソッドは、システムの堅牢性やセキュリティを確保するために重要です。例えば、特定の警告メッセージが特定の条件下で発生しないことを保証したり、出力される情報が意図しない形式になっていないことを確認したりすることで、品質の高いソフトウェア開発に貢献します。

Copy
1import assert from 'node:assert';
2
3// このアサーションは成功します。最初の文字列に正規表現がマッチしないため、エラーはスローされません。
4assert.doesNotMatch('Node.js は素晴らしい', /Python/);
5
6// このアサーションは失敗し、AssertionErrorをスローします。
7// 'Hello World' に /World/ がマッチしてしまうためです。
8// プログラムの実行が中断されるため、ここでは構文を示すため、コメントアウトしています。
9// assert.doesNotMatch('Hello World', /World/, '指定されたパターンが文字列内で見つかってしまいました。');

string, regexp, message = undefined

• string: チェック対象の文字列
• regexp: チェックに使用する正規表現
• message: string (optional): マッチしなかった場合に表示されるエラーメッセージ

戻り値なし

戻り値はありません