はじめに
このエントリは、初挑戦カレンダー Advent Calendar 2025 の 21日目記事です。
https://qiita.com/advent-calendar/2025/silvia
今年、Twitterで何か主張したかったことを拾いながら記事を書いていきます。
2025年のTwitterネタが切れました。2024から拾うしかない。
本文
「正常な動作」とは何か。
画面にUIが問題なく表示されることか、それとも画面にエラーが表示されることか。
テスト仕様書を書くのは、実は簡単なようでいてとても面倒くさい。
テストの手順を記載し、その手順を行った結果発生する現象が想定通りかどうか確認するための手順も書く必要がある。
ただ、テスト仕様書を書く段階と言うのは開発がかなり佳境で、そんな手間のかかる仕様書なんて書いてられないという話も実はある。
結合、総合テストなどはそれでもガチガチに書かないと納品物として機能しないためそれなりに書かれる事が多いのだが、私が関わって来た案件ではかなり適当に書かれているの単体テスト仕様書を見る事が多かった。
そして私もかなり適当に書いてきた。
最初の話に戻る。
テストの期待する結果として「正常に動作すること」と書きたいのはとてもよくわかる。
だがそれではテスト仕様書として機能しないのだ。
その「正常」と言うのは、設計書を読み、実装されている機能を実際に使い、コードを見ながら仕様通り動いているね!と確認しなければ正常かどうか判断できない。
もしそのテスト仕様書が、新人とか手の空いてる人に渡り、テスト仕様書に「正常に動作すること」と書いてあったら、なんか画面が出ただけで正常動作と認識してOKにするだろう。
それがエラー発生のテストだったとしてもだ。
ではテスト仕様書には何を書くのか。
私がいつも心がけているのは、入力と出力を記載することだ。
フロントエンドの画面から、入力フォームの全ての項目について入力値を記載する。
任意項目についても、省かずにできるだけ書く。
事前に必要なDBレコードがあればそれも書く。
その結果、その入力を行った時にどうなるか、というのを期待する結果に書く。
DBのレコードがどのような内容になるかも書く。
それって既にテストしてるのでは?と思われるかもしれないが、
その通り、テストしながらテスト仕様書を書いている。
その途中で変なバグに気付いたりもするので、これはこれでアリだと思う。
入力データ類をテスト仕様書に書くのはかなり面倒だが、このデータを書かないと、テスト実施者はどういうテストをしていいかわからない。
わからないので、適当に入力して、想定外の結果になったり、上手くテストできないんですけど…とテスト仕様書作成者に質問が来る。
手を放したはずなのにまた戻ってきている。本末転倒だ。
「正常に動作すること」 は作った人にしかわからない。
きちんとしたテスト仕様書を作るのであれば、手抜きコピペではやはりだめなのだ。