1年目の私に伝えたい！テストコードを怖がらなくなるためのヒント/Tips for not being afraid of test code

Transcript

1. 1年目の私に伝えたい！ テストコードを怖がらなくなるための ヒント💡 2025/02/22 PHPカンファレンス名古屋2025 #phpcon_nagoya #q
2. 自己紹介 名前 プッシュ（@push_gawa） 所属 株式会社カオナビ 職種 バックエンドエンジニア #phpcon_nagoya #q
3. 挫折 #phpcon_nagoya #q
4. 😱 1年目の私 一つのAPIのテスト作成に １週間かけたが大失敗 #phpcon_nagoya #q
5. 原因 • なぜテストを書くのかわからない • どんなテストケースを書けばいいのか わからない • テストの書き方もわからない #phpcon_nagoya #q
6. 😱 1年目の私 テストを書くことさえ、できなかった #phpcon_nagoya #q
7. 📝 今日話すこと • なぜテストを書くのか • 私なりのテストの書き方 • テストコードを書いたことでの変化 • 一年目の私へのメッセージ #phpcon_nagoya #q
8. なぜテストを書くのか #phpcon_nagoya #q
9. 変更を加えた際に問題がないと 自信を持つために書く テストは #phpcon_nagoya #q
10. 修正箇所は意図した 動作をしていますか？ #phpcon_nagoya #q
11. 修正箇所は意図した 動作をしていますか？ 既存の動作は 壊れていないですか？ #phpcon_nagoya #q
12. YES 修正箇所は意図した 動作をしていますか？ 既存の動作は 壊れていないですか？ #phpcon_nagoya #q
13. テストコードが問題を事前に発見！ - 組織分析機能の開発事例 - 具体例 #phpcon_nagoya #q
14. 組織分析機能イメージ #phpcon_nagoya #q
15. 具体的なレスポンスのイメージ #phpcon_nagoya #q [ { 'department' => '営業部', 'member_count' => 30, }, … … { 'department' => '経理部', 'member_count' => 5, }, ];
16. • 営業部メンバー：30人 • 田中さん ◦ 所属1：営業部 ◦ 所属2：営業第1グループ • 他メンバー：29人 具体的なデータ例 #phpcon_nagoya #q
17. 具体的なデータ例(図) 営業部 [30人] ├── 👔 田中さん ├── 👤 ├── 👤 └── 営業第1グループ ├── 👔 田中さん（兼務） ├── 👤 #phpcon_nagoya #q
18. - 期待する結果：30人 結果 #phpcon_nagoya #q
19. - 期待する結果：30人 - 実際の結果：31人 結果 #phpcon_nagoya #q
20. 差分の原因 営業部 : 👔 田中さん └── 営業第1グループ: 👔 田中さん（兼務） ※同じ人なのに2回カウント #phpcon_nagoya #q
21. ✓ 兼務者の重複カウント問題を発見 ✓ 本番環境に出す前に問題を発見 ✓ 早期に修正対応が可能 テストコードを書いていてよかったこと #phpcon_nagoya #q
22. テストは 変更を加えた際に問題がないと 自信を持つために書く 🔑 ヒント #phpcon_nagoya #q
23. どうやってテストを書くのか #phpcon_nagoya #q
24. テストケース名は test_前提条件_期待する結果 で書く #phpcon_nagoya #q
25. 具体的なコード例 public function test_兼務社員が存在する場合_重複なしで人数がカウントされるべき(): void { } #phpcon_nagoya #q
26. テストコード 1. AAAパターンを使う #phpcon_nagoya #q
27. 具体的なコード例 public function test_兼務社員が存在する場合_重複なしで人数がカウントされるべき(): void { /** Arrange(準備) */ /** Act(実行) */ /** Assert(確認) */ } #phpcon_nagoya #q
28. テストコード 1. AAAパターンを使う 2. 期待値を先に書く #phpcon_nagoya #q
29. 具体的なコード例 public function test_兼務社員が存在する場合_重複なしで人数がカウントされるべき(): void { /** Arrange(準備) */ /** Act(実行) */ /** Assert(確認) */ $expected = [ 'department' => '営業部', 'member_count' => 30, ]; $response->assertExactJson($expected) ->assertOk(); } #phpcon_nagoya #q
30. テストコード 1. AAAパターンを使う 2. 期待値を先に書く 3. コメント駆動で実現したいことを書く #phpcon_nagoya #q
31. 具体的なコード例 /** Assert(確認) */ $expected = [ 'department' => '営業部', 'member_count' => 30, ]; $response ->assertExactJson($expected) ->assertOk(); } public function test_兼務社員が存在する場合_重複な しで人数がカウントされるべき(): void { /** Arrange(準備) */ // 田中さんを営業部で登録 // 田中さんを営業第一グループで登録 /** Act(実行) */ // API叩く #phpcon_nagoya #q
32. テストコード 1. AAAパターンを使う 2. 期待値を先に書く 3. コメント駆動で実現したいことを書く 4. 実際にコードを書いていく #phpcon_nagoya #q
33. 具体的なコード例 public function test_兼務社員が存在する場合_重複なし で人数がカウントされるべき(): void { /** Arrange(準備) */ Department::query()->insert([ // 田中さんを営業部で登録 [ 'id' => 1, 'name' => '営業部', 'member' => '田中', ], // 田中さんを営業第一で登録 [ 'id' => 2, 'name' => '営業第一', 'member' => '田中', ], ]); /** Act(実行) */ // API叩く $response = $this->getAjax(self::URI); /** Assert(確認) */ $expected = [ 'department' => '営業部', 'member_count' => 30, ]; $response ->assertExactJson($expected) ->assertOk(); } #phpcon_nagoya #q
34. テストを書くときは 段階的に書いて、やることを明確にしよう 🔑 ヒント #phpcon_nagoya #q
35. 私の中での変化 #phpcon_nagoya #q
36. • テストを書くことが「怖い」=>「楽しい」になった • レビューでの質問などがしやすくなった • とりあえず動くものが作れるようになった 変化 #phpcon_nagoya #q
37. ✨ 1年目の私へ #phpcon_nagoya #q テストコードは僕たちの未来を守ってくれる道具さ 失敗を恐れないで小さく始めよう
38. ご清聴ありがとうございました #phpcon_nagoya #q