Go table-driven tests: тесты в таблице

Категория: Backend · Язык: Go · Обновлено:

Table-driven test описывает случаи в срезе структур и запускает их в одном тесте. Это уменьшает дублирование и делает отчёт по каждому случаю через t.Run. В Go такой стиль считается идиоматичным для функций с несколькими входными вариантами.

Описать случаи таблицей

Go
package calc

import "testing"

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

func TestAdd(t *testing.T) {
    tests := []struct {
        name string
        a, b int
        want int
    }{
        {"positive", 2, 3, 5},
        {"negative", -2, -3, -5},
        {"zero", 0, 0, 0},
    }

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

t.Run создаёт подтест с именем, поэтому в выводе видно, какой случай упал. t.Fatalf останавливает только текущий подтест. Для проверки ошибок добавьте поле wantErr bool и отдельную ветку; для сложных структур используйте reflect.DeepEqual или cmp.Diff.

Добавить параллельность

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

t.Parallel запускает подтесты параллельно; до Go 1.22 переменную цикла нужно копировать (tt := tt), иначе все горутины увидят последний элемент. В Go 1.22+ переменная цикла создаётся на каждой итерации, но явное копирование не вредит и помогает при сборке старым компилятором.

Не делайте таблицу огромной: если случаев десятки, вынесите данные в отдельный файл или генерируйте их. Названия должны быть короткими и уникальными; повтор имени даст суффикс #01. Для интеграционных тестов с внешними ресурсами используйте t.Cleanup и не запускайте их параллельно без изоляции.

Table-driven test проверяет поведение, а не реализацию. Не сравнивайте приватные поля и не дублируйте логику функции в тесте: ожидаемые значения должны быть независимыми.

Документация: Go testing, table-driven tests.