Thêm một test — Tài liệu Go tiếng Việt

Giờ mã của bạn đã ở trạng thái ổn định (nhân tiện, làm tốt lắm), hãy thêm một test. Kiểm thử mã trong lúc phát triển có thể phơi bày những lỗi lọt vào khi bạn thay đổi mã. Trong chủ đề này, bạn sẽ thêm test cho hàm Hello.

Lưu ý: Chủ đề này là một phần của loạt hướng dẫn nhiều phần, bắt đầu từ Tạo một Go module.

Việc Go hỗ trợ sẵn unit testing giúp bạn kiểm thử dễ dàng ngay trong quá trình làm. Cụ thể, nhờ các quy ước đặt tên, package testing của Go, và lệnh go test, bạn có thể viết và chạy test rất nhanh.

Trong thư mục greetings, tạo một tệp tên là greetings_test.go.

Việc đặt tên tệp kết thúc bằng _test.go cho lệnh go test biết rằng tệp này chứa các hàm test.
Trong greetings_test.go, dán đoạn mã sau vào và lưu tệp lại.
```
package greetings

import (
    "testing"
    "regexp"
)

// TestHelloName calls greetings.Hello with a name, checking
// for a valid return value.
func TestHelloName(t *testing.T) {
    name := "Gladys"
    want := regexp.MustCompile(`\b`+name+`\b`)
    msg, err := Hello("Gladys")
    if !want.MatchString(msg) || err != nil {
        t.Errorf(`Hello("Gladys") = %q, %v, want match for %#q, nil`, msg, err, want)
    }
}

// TestHelloEmpty calls greetings.Hello with an empty string,
// checking for an error.
func TestHelloEmpty(t *testing.T) {
    msg, err := Hello("")
    if msg != "" || err == nil {
        t.Errorf(`Hello("") = %q, %v, want "", error`, msg, err)
    }
}
```
Trong đoạn mã này, bạn:
- Hiện thực các hàm test trong cùng package với mã mà bạn đang kiểm thử.
- Tạo hai hàm test để kiểm thử hàm greetings.Hello. Tên hàm test có dạng TestName, trong đó Name nói lên điều gì đó về test cụ thể. Ngoài ra, hàm test nhận một con trỏ tới kiểu testing.T của package testing làm tham số. Bạn dùng các method của tham số này để báo cáo và ghi log từ test của mình.
- Hiện thực hai test:
  - TestHelloName gọi hàm Hello, truyền vào một giá trị name mà với nó hàm phải trả về được thông điệp hợp lệ. Nếu lời gọi trả về lỗi hoặc một thông điệp ngoài mong đợi (thông điệp không chứa tên bạn đã truyền vào), bạn dùng method Errorf của tham số t để in thông báo ra console.
  - TestHelloEmpty gọi hàm Hello với một chuỗi rỗng. Test này được thiết kế để xác nhận phần xử lý lỗi của bạn hoạt động đúng. Nếu lời gọi trả về chuỗi khác rỗng hoặc không có lỗi, bạn dùng method Errorf của tham số t để in thông báo ra console.
Tại dòng lệnh trong thư mục greetings, chạy lệnh go test để thực thi test.

Lệnh go test thực thi các hàm test (có tên bắt đầu bằng Test) trong các tệp test (có tên kết thúc bằng _test.go). Bạn có thể thêm cờ -v để có đầu ra chi tiết, liệt kê tất cả các test cùng kết quả của chúng.

Các test sẽ pass.
```
$ go test
PASS
ok      example.com/greetings   0.364s

$ go test -v
=== RUN   TestHelloName
--- PASS: TestHelloName (0.00s)
=== RUN   TestHelloEmpty
--- PASS: TestHelloEmpty (0.00s)
PASS
ok      example.com/greetings   0.372s
```
Cố tình làm hỏng hàm greetings.Hello để xem một test thất bại.

Hàm test TestHelloName kiểm tra giá trị trả về đối với cái tên bạn đã chỉ định làm tham số cho hàm Hello. Để xem kết quả một test thất bại, hãy sửa hàm greetings.Hello sao cho nó không còn chứa cái tên nữa.

Trong greetings/greetings.go, dán đoạn mã sau thay cho hàm Hello. Hãy để ý rằng những dòng được đánh dấu đã thay đổi giá trị mà hàm trả về, như thể đối số name đã vô tình bị bỏ đi.
```
// Hello returns a greeting for the named person.
func Hello(name string) (string, error) {
    // If no name was given, return an error with a message.
    if name == "" {
        return name, errors.New("empty name")
    }
    // Create a message using a random format.
    // message := fmt.Sprintf(randomFormat(), name)
    message := fmt.Sprint(randomFormat())
    return message, nil
}
```
Tại dòng lệnh trong thư mục greetings, chạy go test để thực thi test.

Lần này, hãy chạy go test mà không có cờ -v. Đầu ra sẽ chỉ gồm kết quả của những test thất bại, điều này hữu ích khi bạn có nhiều test. Test TestHelloName sẽ thất bại – còn TestHelloEmpty vẫn pass.
```
$ go test
--- FAIL: TestHelloName (0.00s)
    greetings_test.go:15: Hello("Gladys") = "Hail, %v! Well met!", <nil>, want match for `\bGladys\b`, nil
FAIL
exit status 1
FAIL    example.com/greetings   0.182s
```

Ở chủ đề tiếp theo (và cũng là cuối cùng), bạn sẽ thấy cách biên dịch và cài đặt mã của mình để chạy nó trên máy cục bộ.