260116 さらば「指差し確認」！ TestState APIで変わる、これからのServerless Testing

2026/01/16(金) Serverless Meetup Fukuoka #6 にて発表した登壇資料。
https://serverless.connpass.com/event/375928/

Transcript

1. さらば「指差し確認」！ 
 TestState APIで変わる、 
 これからのServerless Testing 
 2026-01-16 Serverless Meetup Fukuoka #6
 KDDIアジャイル開発センター株式会社　阿部拓海（あべたく） 

2. 1 KDDI Agile Development Center Corporation $ whoami 
 あべたく @east_takumi
 {
 　"普段" : {
 　　"会社": "KDDIアジャイル開発センター株式会社(KAG)", 
 　　"職種": "Webバックエンドエンジニア",
 　　"ニックネーム": "あべたく",
 　　"最近": "わい明日10時に別府（さっきまで別府いた...）",
 　 　},
 　"コミュニティ活動": [
 　　"JAWS-UG おおいた&福岡",
 　　"福岡クラウドUG",
 　　"AWS Community Builder(Serverless)"
 　],
 }
 }

3. 2 KDDI Agile Development Center Corporation みなさん、 
 StepFunctionsのテストはやってますか？ 

4. 3 KDDI Agile Development Center Corporation テスト自動化できてますか？ 

5. 4 KDDI Agile Development Center Corporation StepFunctionsのテストってどうしてます？ 
 (手順書をみて) 最初のLambdanの出 力！ ヨシっ！
6. 5 KDDI Agile Development Center Corporation 辛いです（率直） 

7. 6 KDDI Agile Development Center Corporation Serverlessアプリケーションのテストについて考えてきた 

8. 7 KDDI Agile Development Center Corporation 2025年11月 
 ついに求めてたものが、、、、 

9. 8 KDDI Agile Development Center Corporation
10. 9 KDDI Agile Development Center Corporation アジェンダ 
 1
 2
 3
 4
 TestState API って？ 2025年11月のアップデートについて
 じゃあ何ができるようになったの？
 まとめ

11. 10 KDDI Agile Development Center Corporation TestState API って？ 

12. 11 KDDI Agile Development Center Corporation TestState API とは？ 
 Step Functionsの 1つのステートだけ を実行し、 
 入出力や途中データ(エラー箇所)などを確認するためのAPI 

13. 12 KDDI Agile Development Center Corporation TestState API とは？ 
 めちゃ嬉しかったこと 
 • ステート単体のお試し実行 
 • 入出力処理を可視化 
 悩ましかったこと 
 • デプロイをする必要があった 
 • それぞれのリソースを動かす権限が必要 

14. 13 KDDI Agile Development Center Corporation TestState API とは？ 
 Task stateの中身を検証可能 
 • INFO
 ◦ State Outputのみ返す
 • DEBUG
 ◦ 中間データを全て返す

15. 14 KDDI Agile Development Center Corporation 今回のアップデートについて 

16. 15 KDDI Agile Development Center Corporation 今回のアプデ 
 - ステートマシン全体 + stateName でテスト 
 - サービス統合/HTTP のモック & コントラクトチェック 
 - Map / Parallel / Activity / .sync 系も含めた全てのステートパターンが 
 テスト対象に 
 - Retry / Catch のエラー処理設計のテスト 

17. 16 KDDI Agile Development Center Corporation 今回のアプデ 
 - ステートマシン全体 + stateName でテスト 
 - サービス統合/HTTP のモック & コントラクトチェック 
 - Map / Parallel / Activity / .sync 系も含めた全てのステートパターンが 
 テスト対象に 
 - Retry / Catch のエラー処理設計のテスト 

18. 17 KDDI Agile Development Center Corporation ステートマシン全体 + stateName でテスト 
 以前
 1つのステートのみの定義したJSONしか 
 渡せなかった 

19. 18 KDDI Agile Development Center Corporation ステートマシン全体 + stateName でテスト 
 アプデ後
 ワークフロー全体を定義したJSONを渡して 
 ステート名を指定すれば、 
 そのステートへのUTが実行できる。 
 
 レスポンスとして下記が返ってくる 
 • 実行結果
 • 次のステート名 

20. 19 KDDI Agile Development Center Corporation ステートマシン全体 + stateName でテスト 

21. 20 KDDI Agile Development Center Corporation ステートマシン全体 + stateName でテスト 

22. 21 KDDI Agile Development Center Corporation ステートマシン全体 + stateName でテスト 
 以前
 • definition 
 ◦ 1つのステートのみの定義したJSON 
 アプデ後
 • definition 
 ◦ ワークフロー全体を定義したJSON 
 • stateName 
 ◦ definitionで定義したステートの中からテ ストしたいステート 
 あくまで、 
 1つのステートをテストする ことは変わらない 

23. 22 KDDI Agile Development Center Corporation サービス統合/HTTP のモック & コントラクトチェック 
 AWSサービス統合やHTTP Taskの結果をモックが可能に！ 
 →実際のサービスを叩かなくて済む(権限もTestState API実行のみでOK) 
 ※ 一部サービスを除く
 さらに実際のAWSサービスのレスポンス仕様と合っているかチェックする 
 チェックレベルがいくつかある
 • STRICT
 ◦ 実際に返るレスポンスと完全一致するかを見る
 • PRESENT
 ◦ mockに書かれてるパラメータだけみる
 • NONE
 ◦ オールスルーする

24. 23 KDDI Agile Development Center Corporation サービスモックのコントラクトチェックの例 
 Ex. DynamoDBのPutItemを想定
 STRICTの場合 
 
 中の属性が型つきか？ mockで指定する型と一致してるか？ etc. 必須フィールドがあるか？ フィールド名ミスがないか？ etc. number型になっているか？ etc.
25. 24 KDDI Agile Development Center Corporation サービスモックのコントラクトチェックの例 
 Ex. DynamoDBのPutItemを想定
 PRESENTの場合 
 
 一部mockに記載がなかったりするケースは OK →mockに記載があるもののみみる！ NG例 - mockに記載があるオブジェクトの型が違う
26. 25 KDDI Agile Development Center Corporation サービスモックのコントラクトチェックの例 
 Ex. DynamoDBのPutItemを想定
 NONEの場合 
 
 何も見ない！！！w 型定義?オブジェクト一致？知ったものかそんなもの！
27. 26 KDDI Agile Development Center Corporation 注意点
 ❌これはできない
 ローカルで確認したい！(実際のAWSリソースを操作したくない) &&
 Lambdaのコードもローカルにある &&
 Lambdaのステートをローカルコードでテスト したい
 
 
 

28. 27 KDDI Agile Development Center Corporation 注意点
 ❌これはできない
 ローカルで確認したい！(実際のAWSリソースを操作したくない) &&
 Lambdaのコードもローカルにある &&
 Lambdaのステートをローカルコードでテスト したい
 
 TestState APIは AWS上リソースしか 呼び出せない 
 
 
 

29. 28 KDDI Agile Development Center Corporation じゃあ何ができるようになったの？ 

30. 29 KDDI Agile Development Center Corporation 擬似的なインテグレーションテストがより高いレベルで？ 
 下記の情報を渡してテストする 
 definition→ワークフロー定義 
 stateName→テストしたいステート 
 input→ステートに渡すInput 
 mock→モックする結果 

31. 30 KDDI Agile Development Center Corporation 擬似的なインテグレーションテストがより高いレベルで？ 
 次のステートが終了対象でなければ、 
 実行結果からデータを渡して再度TestState APIを実行する 
 nextState→stateName 
 output→input 

32. 31 KDDI Agile Development Center Corporation 個人的な感想/まとめ 

33. 32 KDDI Agile Development Center Corporation 個人的な感想 
 • 「強力な」単体テストは名に恥じない
 • モックやMapなどの対応はStep Functions自体のテストの目的が 大きそう(おそらく)
 • インテグレーションテストをコード化できる利点が強い！
 （割と副産物な感じがする）
 

34. 33 KDDI Agile Development Center Corporation まとめ
 1. TestState APIは1つのステートだけをテストするAPI
 2. ステートマシン全体の文脈からステート単体テストが可能
 3. サービス統合をモック & コントラクトチェックできる
 4. これでインテグレーションテストがコード化&&自動化！泣

35. Be a Change Leader.
 アジャイルに力を与え
 共に成長し続ける社会を創る