【JavaScript, Test】テストコードを書く際に「consistent-test-it」を設定しておく

こんにちは。野中やすおです。

最近テストコードを書く際にconsistent-test-itというESLintエラーで怒られてしまいました。ということで一体どういう設定なのかを調べてみました。

consistent-test-itとは何か?

JavaScriptやTypeScriptのテストフレームワーク( JestやVitestなど)で使用されるESLintのルールの1つです。consistent-test-itは、test と it の使い方の一貫性を保つためルールとして便利です。

JestやVitestではitとtestは同じ意味ですが、ファイルによってバラバラに使われていると可読性が下がってしまいます。ということでコードベース全体で test または it のどちらか一方を使うことを強制し、一貫性を保ちます。

consistent-test-itの設定方法

上記で、“fn”オプションで、プロジェクト内のすべてのテストで test 関数の使用を強制し、itを使用した場合にはエラーを出力します。

参考

JestやVitestにおけるno-conditional-in-testのプラグインを参考にしました。

https://github.com/jest-community/eslint-plugin-jest/blob/main/docs/rules/consistent-test-it.md

https://github.com/veritem/eslint-plugin-vitest/blob/main/docs/rules/consistent-test-it.md