Go言語のテストでエラー出力を確認する方法と工夫

先生と生徒の会話形式で理解しよう

生徒

「Go言語でテストを書いているとき、エラー出力を確認するにはどうすればいいですか？」

先生

「Goではtestingパッケージのt.Errorやt.Errorfを使ってエラーを出力できます。また、標準出力や標準エラーに書き出すことで、どの部分で失敗したかを確認できます。」

生徒

「標準出力に書くのと、テスト結果で確認するのは違うんですか？」

先生

「はい、標準出力は実行中の情報を見るために使い、t.Errorはテストの失敗として記録されます。両方をうまく使うとデバッグがしやすくなります。」

1. エラー出力の基本

Go言語の単体テストでは、t.Errorやt.Errorfを使ってテスト失敗時にメッセージを出力します。t.Errorは文字列を出力してテストを失敗させます。t.Errorfはフォーマット付きでメッセージを出力できるので、変数の値も確認できます。

2. 基本的な使い方

次の例は、整数の加算関数をテストして、期待した値と異なる場合にエラー出力を確認する方法です。


package main

import "testing"

func Add(a, b int) int {
    return a + b
}

func TestAdd(t *testing.T) {
    got := Add(2, 3)
    want := 6
    if got != want {
        t.Errorf("Add(2, 3) = %d; want %d", got, want)
    }
}

この場合、gotの値がwantと異なるため、テストは失敗し、エラー出力が表示されます。

3. 標準出力を使ったデバッグ

テスト中に変数の値や処理の流れを確認したいときは、fmt.Printlnを使って標準出力に表示する方法もあります。テストが失敗する原因を特定するのに便利です。


import "fmt"

func TestAddDebug(t *testing.T) {
    a, b := 2, 3
    got := Add(a, b)
    fmt.Println("Debug: a =", a, "b =", b, "got =", got)
    want := 5
    if got != want {
        t.Errorf("Add(%d, %d) = %d; want %d", a, b, got, want)
    }
}

このように出力すると、どの値が想定と異なるかを確認できます。ただし、大量のテストでは出力が多くなるため、必要な箇所だけ出力する工夫が重要です。

4. エラー出力の工夫

複雑な関数をテストする場合、エラー出力をわかりやすくする工夫が役立ちます。例えば、テストケースに名前を付けたり、サブテストとして実行する方法があります。


func TestAddTable(t *testing.T) {
    tests := []struct {
        name string
        a, b int
        want int
    }{
        {"2と3の加算", 2, 3, 5},
        {"0と5の加算", 0, 5, 5},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            got := Add(tt.a, tt.b)
            if got != tt.want {
                t.Errorf("Add(%d, %d) = %d; want %d", tt.a, tt.b, got, tt.want)
            }
        })
    }
}

このようにサブテストに名前をつけると、どのケースが失敗したか一目でわかります。エラー出力が整理され、デバッグが効率的になります。

Go言語を基礎からスッキリ学びたい人や、文法だけでなく「実用的な使い方」まで押さえたい人には、定番の入門書がこちらです。

基礎からわかるGo言語をAmazonで見る

※ Amazon広告リンク

5. 初心者向けのポイント

初心者はまずt.Errorやt.Errorfを使ってエラー出力を確認することから始めましょう。テストケースに名前を付ける、標準出力で変数の値を確認する、必要に応じてサブテストを活用する、といった工夫で、テストの可読性とデバッグ効率が大きく向上します。Go言語のテストでエラー出力を上手に活用することは、バグを早く発見し、品質の高いプログラムを書くために重要なスキルです。