単体テストフレームワーク完全ガイド - Qiita

単体テストフレームワーク完全ガイド #Jest - Qiita 3 いいねしたユーザー一覧へ移動 5 X（Twitter）でシェアする Facebookでシェアする はてなブックマークに追加する more_horiz 記事を削除する close 一度削除した記事は復旧できません。 この記事の編集中の下書きも削除されます。 削除してよろしいですか？ キャンセル 削除する delete info この記事は最終更新日から1年以上が経過しています。 @ masterpiecehack 単体テストフレームワーク完全ガイド JUnit 単体テスト フレームワーク カバレッジ Jest 3 最終更新日 2025年03月08日 投稿日 2025年03月08日 目次 はじめに 単体テストの基本 主要なプログラミング言語別テストフレームワーク テスト駆動開発（TDD） モック、スタブ、スパイの活用 アサーションの書き方 テストカバレッジ 実践的なテスト戦略 CI/CDパイプラインでのテスト自動化 ベストプラクティスとパターン よくある問題とその解決法 参考資料とコミュニティ はじめに このガイドは、システムエンジニアやソフトウェア開発者が単体テストフレームワークを効果的に活用するための包括的な情報を提供することを目的としています。テストフレームワークの選定から実装、運用までの全過程をカバーし、実務での即戦力となる知識を体系的にまとめています。 単体テストは、ソフトウェア品質を確保するための基本的な手段であり、近年の開発現場では必須とされています。適切な単体テストを実施することで、バグの早期発見、コードの品質向上、リファクタリングの安全性確保など、多くのメリットが得られます。 単体テストの基本 単体テストとは 単体テスト（Unit Test）は、ソフトウェアの最小単位（関数、メソッド、クラスなど）が正しく動作することを検証するテストです。通常、以下の特徴を持ちます： 独立性 : 他のテストや外部リソースに依存せず独立して実行できる 自動化 : 手動操作なしで自動的に実行できる 繰り返し可能 : 何度実行しても同じ結果が得られる 迅速 : 実行時間が短い（理想的には数ミリ秒から数秒） なぜ単体テストが重要か バグの早期発見 : 開発初期段階でバグを発見し、修正コストを削減 設計の改善 : テスト可能なコードを書くことで、自然と良い設計が促進される リファクタリングの安全性 : コードを変更した際に既存の機能が破壊されていないことを確認 ドキュメント効果 : テストコードが実装コードの使用例として機能 開発スピードの向上 : 長期的には手動テストの削減によりスピードアップ 品質の向上 : システム全体の品質と信頼性の向上 単体テストのライフサイクル 単体テストは通常、以下のようなライフサイクルで実施されます： テスト計画 : 何をテストするか、どのようにテストするかを決定 テスト設計 : テストケースを設計（入力値、期待結果など） テスト実装 : テストフレームワークを使用してテストコードを実装 テスト実行 : テストを実行し、結果を確認 バグ修正 : テスト失敗時にコードを修正 リファクタリング : テストをパスした後にコードを改善 回帰テスト : 変更後も既存の機能が正しく動作することを確認 主要なプログラミング言語別テストフレームワーク Java JUnit 5 JUnit は Java の標準的なテストフレームワークであり、最新版の JUnit 5 は、JUnit Platform、JUnit Jupiter、JUnit Vintage の3つのサブプロジェクトから構成されています。 主な特徴 : アノテーションベースのテスト記述 パラメータ化テスト 動的テスト テストライフサイクルコールバック 条件付きテスト実行 基本的な使用例 : import org.junit.jupiter.api.Test ; import static org . junit . jupiter . api . Assertions .*; class CalculatorTest { @Test void addition () { Calculator calculator = new Calculator (); assertEquals ( 5 , calculator . add ( 2 , 3 ), "2 + 3 should equal 5" ); } @Test void divisionByZero () { Calculator calculator = new Calculator (); assertThrows ( ArithmeticException . class , () -> calculator . divide ( 1 , 0 )); } } TestNG TestNG は JUnit をインスピレーションとして開発されたフレームワークで、より多くの機能を提供します。 主な特徴 : 柔軟なテスト設定（XML設定ファイル） 依存テスト グループ化テスト データプロバイダによるパラメータ化テスト マルチスレッドテスト実行 基本的な使用例 : import org.testng.annotations.Test ; import static org . testng . Assert .*; public class CalculatorTest { @Test public void testAddition () { Calculator calculator = new Calculator (); assertEquals ( calculator . add ( 2 , 3 ), 5 , "2 + 3 should equal 5" ); } @Test ( expectedExceptions = ArithmeticException . class ) public void testDivisionByZero () { Calculator calculator = new Calculator (); calculator . divide ( 1 , 0 ); } } Spock Framework Spock は Groovy で書かれたフレームワークですが、Java コードのテストに広く使用されています。 主な特徴 : 表現力豊かな仕様記述言語 given-when-then 構造 データ駆動テスト モック機能の内蔵 拡張性の高さ 基本的な使用例 : import spock.lang.Specification class CalculatorSpec extends Specification { def "adding two numbers" () { given: def calculator = new Calculator () when: def result = calculator . add ( 2 , 3 ) then: result == 5 } def "division by zero throws exception" () { given: def calculator = new Calculator () when: calculator . divide ( 1 , 0 ) then: thrown ( ArithmeticException ) } } JavaScript/TypeScript Jest Jest は Facebook が開発した JavaScript テストフレームワークで、React アプリケーションのテストに最適ですが、他の JavaScript プロジェクトでも広く使用されています。 主な特徴 : ゼロコンフィグ（設定なしで使用可能） スナップショットテスト モック、スパイ、タイマーのモック機能 コードカバレッジレポート 並列テスト実行 基本的な使用例 : // calculator.js function add ( a , b ) { return a + b ; } function divide ( a , b ) { if ( b === 0 ) throw new Error ( ' Cannot divide by zero ' ); return a / b ; } module . exports = { add , divide }; // calculator.test.js const { add , divide } = require ( ' ./calculator ' ); test ( ' adds 2 + 3 to equal 5 ' , () => { expect ( add ( 2 , 3 )). toBe ( 5 ); }); test ( ' division by zero throws an error ' , () => { expect (() => divide ( 1 , 0 )). toThrow ( ' Cannot divide by zero ' ); }); Mocha + Chai Mocha はテストランナーであり、Chai はアサーションライブラリです。この組み合わせは非常に柔軟性が高く、様々なプロジェクトで使用されています。 主な特徴 : 柔軟なテスト構造 非同期テストのサポート 多様なレポート形式 プラグイン拡張性 BDD、TDD スタイルのサポート 基本的な使用例 : // calculator.js function add ( a , b ) { return a + b ; } function divide ( a , b ) { if ( b === 0 ) throw new Error ( ' Cannot divide by zero ' ); return a / b ; } module . exports = { add , divide }; // calculator.test.js const { add , divide } = require ( ' ./calculator ' ); const { expect } = require ( ' chai ' ); describe ( ' Calculator ' , function () { describe ( ' add() ' , function () { it ( ' should add two numbers correctly ' , function () { expect ( add ( 2 , 3 )). to . equal ( 5 ); }); }); describe ( ' divide() ' , function () { it ( ' should throw an error when dividing by zero ' , function () { expect (() => divide ( 1 , 0 )). to . throw ( ' Cannot divide by zero ' ); }); }); }); Jasmine Jasmine は行動駆動開発（BDD）風のテストフレームワークで、ブラウザとNode.jsの両方で動作します。 主な特徴 : BDD構文 組み込みのアサーション スパイとモック機能 非同期テストのサポート ブラウザ、Node.js両対応 基本的な使用例 : // calculator.js function add ( a , b ) { return a + b ; } function divide ( a , b ) { if ( b === 0 ) throw new Error ( ' Cannot divide by zero ' ); return a / b ; } // calculator.spec.js describe ( ' Calculator ' , function () { describe ( ' add ' , function () { it ( ' should add two numbers correctly ' , function () { expect ( add ( 2 , 3 )). toBe ( 5 ); }); }); describe ( ' divide ' , function () { it ( ' should throw an error when dividing by zero ' , function () { expect ( function () { divide ( 1 , 0 ); }). toThrowError ( ' Cannot divide by zero ' ); }); }); }); Python pytest pytest は Python のシンプルでありながら強力なテストフレームワークです。最小限の設定で始められますが、プラグインによる拡張性も高いです。 主な特徴 : シンプルで直感的なAPI フィクスチャの柔軟な管理 パラメータ化テスト 詳細なエラー報告 豊富なプラグインエコシステム 基本的な使用例 : # calculator.py class Calculator : def add ( self , a , b ): return a + b def divide ( self , a , b ): if b == 0 : raise ValueError ( " Cannot divide by zero " ) return a / b # test_calculator.py import pytest from calculator import Calculator def test_add (): calc = Calculator () assert calc . add ( 2 , 3 ) == 5 def test_divide_by_zero (): calc = Calculator () with pytest . raises ( ValueError , match = " Cannot divide by zero " ): calc . divide ( 1 , 0 ) unittest unittest は Python 標準ライブラリに含まれるテストフレームワークで、JUnit にインスパイアされています。 主な特徴 : Python 標準ライブラリの一部 テストフィクスチャ テストスイート 豊富なアサーションメソッド テスト検出 基本的な使用例 : # calculator.py class Calculator : def add ( self , a , b ): return a + b def divide ( self , a , b ): if b == 0 : raise ValueError ( " Cannot divide by zero " ) return a / b # test_calculator.py import unittest from calculator import Calculator class TestCalculator ( unittest . TestCase ): def test_add ( self ): calc = Calculator () self . assertEqual ( calc . add ( 2 , 3 ), 5 ) def test_divide_by_zero ( self ): calc = Calculator () with self . assertRaises ( ValueError ): calc . divide ( 1 , 0 ) if __name__ == ' __main__ ' : unittest . main () C# MSTest MSTest は Microsoft が提供するテストフレームワークで、Visual Studio と緊密に統合されています。 主な特徴 : Visual Studio との統合 テストカテゴリとプライオリティ データ駆動テスト アサーションクラス 初期化とクリーンアップメソッド 基本的な使用例 : using Microsoft.VisualStudio.TestTools.UnitTesting ; [ TestClass ] public class CalculatorTest { [ TestMethod ] public void Add_TwoNumbers_ReturnsSum () { // Arrange var calculator = new Calculator (); // Act var result = calculator . Add ( 2 , 3 ); // Assert Assert . AreEqual ( 5 , result ); } [ TestMethod ] [ ExpectedException ( typeof ( DivideByZeroException ))] public void Divide_ByZero_ThrowsException () { var calculator = new Calculator (); calculator . Divide ( 1 , 0 ); } } NUnit NUnit は .NET 向けの広く使用されるテストフレームワークで、JUnit からインスパイアされています。 主な特徴 : 豊富なアサーション パラメータ化テスト カテゴリによるテストのグループ化 カスタムアサーション テスト実行の並列化 基本的な使用例 : using NUnit.Framework ; [ TestFixture ] public class CalculatorTest { [ Test ] public void Add_TwoNumbers_ReturnsSum () { // Arrange var calculator = new Calculator (); // Act var result = calculator . Add ( 2 , 3 ); // Assert Assert . That ( result , Is . EqualTo ( 5 )); } [ Test ] public void Divide_ByZero_ThrowsException () { var calculator = new Calculator (); Assert . Throws < DivideByZeroException >(() => calculator . Divide ( 1 , 0 )); } } xUnit.net xUnit.net は NUnit の創設者によって作成された、より現代的なテストフレームワークです。 主な特徴 : シンプルな設計 拡張性の高さ 並列テスト実行 データ駆動テスト 共有コンテキスト 基本的な使用例 : using Xunit ; public class CalculatorTest { [ Fact ] public void Add_TwoNumbers_ReturnsSum () { // Arrange var calculator = new Calculator (); // Act var result = calculator . Add ( 2 , 3 ); // Assert Assert . Equal ( 5 , result ); } [ Fact ] public void Divide_ByZero_ThrowsException () { var calculator = new Calculator (); var exception = Assert . Throws < DivideByZeroException >(() => calculator . Divide ( 1 , 0 )); } } Ruby RSpec RSpec は Ruby のための BDD（行動駆動開発）スタイルのテストフレームワークです。 主な特徴 : 自然言語に近い記述 豊富なマッチャー モック・スタブ機能 共有コンテキスト フィルタリング機能 基本的な使用例 : # calculator.rb class Calculator def add ( a , b ) a + b end def divide ( a , b ) raise ZeroDivisionError , "Cannot divide by zero" if b == 0 a / b end end # calculator_spec.rb require 'rspec' require_relative 'calculator' describe Calculator do describe "#add" do it "adds two numbers correctly" do calculator = Calculator . new expect ( calculator . add ( 2 , 3 )). to eq ( 5 ) end end describe "#divide" do it "raises an error when dividing by zero" do calculator = Calculator . new expect { calculator . divide ( 1 , 0 ) }. to raise_error ( ZeroDivisionError ) end end end Minitest Minitest は Ruby の標準ライブラリに含まれるテストフレームワークで、シンプルで軽量です。 主な特徴 : Ruby 標準ライブラリ TDD と BDD 両スタイルをサポート 速度の速さ モック・スタブ機能 ベンチマーク機能 基本的な使用例 : # calculator.rb class Calculator def add ( a , b ) a + b end def divide ( a , b ) raise ZeroDivisionError , "Cannot divide by zero" if b == 0 a / b end end # calculator_test.rb require 'minitest/autorun' require_relative 'calculator' class CalculatorTest < Minitest :: Test def setup @calculator = Calculator . new end def test_add assert_equal 5 , @calculator . add ( 2 , 3 ) end def test_divide_by_zero assert_raises ZeroDivisionError do @calculator . divide ( 1 , 0 ) end end end PHP PHPUnit PHPUnit は PHP の最も広く使われているテストフレームワークです。 主な特徴 : 豊富なアサーション データプロバイダ モック・スタブ機能 テストカバレッジレポート データベー