Paket `pengujian`

Di Go, pengujian adalah bagian dari stdlib: tidak ada pustaka eksternal, tidak ada kerangka kerja yang perlu dikonfigurasi. Yang Anda perlukan hanyalah file *_test.go di samping kode, beberapa fungsi TestXxx, dan perintah go test.

Konvensi dasar

• File pengujian diberi nama <something>_test.go dan berada dalam paket yang sama dengan kode yang diuji (atau dalam paket <name>_test untuk "pengujian kotak hitam").
• Fungsi pengujian memiliki tanda tangan tepat: func TestXxx(t *testing.T) dengan Xxx dimulai dengan huruf besar.
• Anda mengimpor testing dari stdlib.
• Tidak assertEquals: Anda menggunakan if got != want { t.Errorf(...) } dengan kata kerja fmt.

// math.go
package math

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

// math_test.go
package math

import "testing"

func TestSum(t *testing.T) {
    got := Sum(2, 3)
    if got != 5 {
        t.Errorf("Sum(2,3) = %d; voglio %d", got, 5)
    }
}

Jalankan dengan:

go test ./...        # all packages in the module
go test -v ./pkg     # verbose: prints test names
go test -run TestSum  # only tests matching the regex

t.Error vs t.Fatal

Ini adalah dua kata kerja dasar yang menandakan kegagalan:

Aturan praktisnya: gunakan Fatal ketika melanjutkan tidak masuk akal (misalnya, penyiapan gagal, dereferensi penunjuk nihil akan segera terjadi); jika tidak Error, yang memungkinkan Anda melihat semua kegagalan dalam sekali proses.

func TestOpen(t *testing.T) {
    f, err := os.Open("fixtures/sample.txt")
    if err != nil {
        t.Fatal(err) // if it doesn't open, the next steps would fail on nil
    }
    defer f.Close()
    // ... assert on content with t.Errorf
}

Penyiapan dan pembongkaran dengan t.Cleanup

Untuk melepaskan sumber daya di akhir pengujian (atau subtes), gunakan t.Cleanup alih-alih defer:

func TestDB(t *testing.T) {
    db := newTestDB(t)
    t.Cleanup(func() { db.Close() })
    // ... test
}

Keuntungan dibandingkan defer: helper yang membuat db dapat mendaftarkan pembersihan secara internal, sehingga penelepon tidak perlu mengingatnya.

Tes pembantu

Metode t.Helper() menandai suatu fungsi sebagai "pembantu": ketika pengujian gagal, pelacakan tumpukan melewati fungsi pembantu dan menunjuk langsung ke pemanggil:

func mustParseInt(t *testing.T, s string) int {
    t.Helper()
    n, err := strconv.Atoi(s)
    if err != nil {
        t.Fatalf("parse %q: %v", s, err)
    }
    return n
}

Latihan

if err != nil {
  t.???(err)
}