TopGit
Đánh giá repo GitHub

Testify: assertion và mock cho kiểm thử Go

stretchr/testify
TTopGit review image for stretchr/testify
Review by Topgit.dev for stretchr/testify, with GitHub repository stats and README context.
Nhận định nhanh

Testify biến các phép so sánh thủ công của testing.T thành các lệnh assert và require chỉ một dòng, còn package mock giúp bạn khỏi phải tự viết struct mock cho từng interface. Nó xứng đáng có mặt trong hầu hết dự án Go có nhiều hơn vài bài test — lợi ích thấy rõ ngay lần đầu bạn so sánh hai struct theo từng field. Điểm trừ: repo này chủ động đóng băng ở v1, nên đừng mong tính năng mới, chỉ có bản vá lỗi và công việc tương thích.

Sao
★ 26.3k
Fork
⑂ 1.9k
Người đóng góp
👥 319
Ngôn ngữ
Go
Giấy phép
MIT
Chủ đề
Backend
Cập nhật
Nov 2026
Trang chủ
GitHub

Testify là gì?

Testify là một toolkit cho Go, gom các assertion thông dụng và mock object, được xây để hoạt động cùng package testing chuẩn chứ không thay thế nó. Nó gồm các package riêng — assert, require, mock và suite — mà bạn import từng cái tùy theo file test cần gì. assert trả về bool nên test có thể chạy tiếp sau khi một check thất bại, còn require gọi cùng các assertion đó nhưng dừng test ngay lập tức qua t.FailNow.

Testify cung cấp những package nào?

  • ✓Package assert — các assertion so sánh một dòng (Equal, Nil, NotNil, và nhiều hàm khác) in ra thông báo lỗi dễ đọc và trả về bool thay vì dừng test.
  • ✓Package require — cùng các hàm assertion như assert, nhưng mỗi hàm gọi t.FailNow khi thất bại nên test dừng ngay tại đó; phải được gọi từ chính goroutine đang chạy test.
  • ✓Package mock — dựng mock object bằng cách nhúng mock.Mock, khai báo kỳ vọng với On/Return, rồi kiểm tra lại bằng AssertExpectations.
  • ✓Package suite — nhóm các test liên quan thành một struct với các hook kiểu SetupTest, chạy qua go test bằng suite.Run; package này không hỗ trợ chạy song song.
  • ✓Chế độ assertion-object — bọc testing.T một lần bằng assert.New(t) hoặc require.New(t) để bỏ tham số t ở mọi lệnh gọi sau đó.
  • ✓Package testify/http — có trong module nhưng README ghi rõ là đã deprecated.
Số sao GitHub của repo này thay đổi thế nào theo thời gian. Nguồn: star-history.com.Xem lịch sử sao ↗

Khi nào nên dùng Testify

  • •Viết test Go khi bạn muốn output pass/fail dễ đọc thay vì so sánh testing.T thô và tự viết thông báo t.Errorf.
  • •Test code phụ thuộc vào một interface (HTTP client, repository) mà bạn muốn mock thay vì gọi thật trong unit test.
  • •Gom các test liên quan thành một suite có setup dùng chung, khi cấu trúc dựa trên struct phù hợp hơn các hàm test rời rạc.
  • •Áp fail-fast bằng require cho các điều kiện tiên quyết, khi việc chạy tiếp test sau một assertion thất bại không còn ý nghĩa.

Cài đặt Testify

Chạy go get github.com/stretchr/testify để thêm Testify vào module của bạn. Chỉ một lệnh cài đặt đó đã mở ra github.com/stretchr/testify/assert, /require, /mock, /suite, và package /http đã deprecated — chỉ import những package mà file test đang cần. Muốn lên bản mới nhất sau này, chạy go get -u github.com/stretchr/testify. README ghi rằng Testify hỗ trợ các phiên bản Go chính mới nhất kể từ 1.19 trở đi.

Viết test với assertion

Một test thông thường import github.com/stretchr/testify/assert rồi gọi các hàm như assert.Equal(t, want, got, "message") hoặc assert.NotNil(t, object) ngay trong một func TestX(t *testing.T) bình thường. Nếu file test có nhiều assertion, bọc testing.T một lần bằng a := assert.New(t) sẽ giúp bỏ tham số t ở mọi lệnh gọi tiếp theo. Với mock, nhúng mock.Mock vào một struct, hiện thực method của interface bằng cách gọi m.Called(args...) rồi đọc lại args.Bool(0) hay args.Error(1), sau đó khai báo kỳ vọng ở nơi khác bằng testObj.On("MethodName", value).Return(returnValue) và kiểm tra bằng testObj.AssertExpectations(t). Suite lại khác hẳn: định nghĩa một struct nhúng suite.Suite, thêm method SetupTest cho phần setup của từng test, viết các method test bắt đầu bằng Test, rồi đưa toàn bộ vào suite.Run(t, new(YourSuite)) từ một hàm go test bình thường.

Điểm mạnh

  • ✓assert/require rút gọn code test xuống còn các lệnh gọi một dòng, với output lỗi nhất quán, dễ đọc thay vì khối if/t.Errorf tự viết.
  • ✓Package mock lo phần theo dõi kỳ vọng (On, Return, AssertExpectations) nên bạn không phải tự làm lại việc đó cho từng interface được mock.
  • ✓v1 chủ động được đóng băng để không có breaking change, nên nâng cấp trong cùng import path sẽ không làm hỏng test suite hiện có.
  • ✓Bốn package — assert, require, mock, suite — phủ đủ so sánh, fail-fast check, mock, và suite dựa trên struct mà không cần kéo thêm thư viện riêng cho từng việc.

Hạn chế đã biết

  • △Package suite không hỗ trợ chạy test song song — README nêu thẳng điều này và dẫn link tới issue #934 đang mở.
  • △Testify chỉ được duy trì ở v1; README nói rõ repo này sẽ không chấp nhận breaking change, nên bất cứ điều gì bạn mong ở v2 vẫn chỉ nằm trong một discussion trên GitHub.
  • △Các hàm require phải được gọi từ chính goroutine đang chạy test hoặc benchmark — gọi từ goroutine khác có thể gây ra race condition, theo README.
  • △Package http đi kèm được README đánh dấu deprecated, nên dự án mới không nên xây dựng dựa vào nó.

Lựa chọn thay thế

Package testing chuẩn của Go — nếu không muốn thêm dependency, assert/require của Testify vốn chỉ bọc lại những gì testing.T đã có sẵn.Ginkgo kết hợp Gomega — framework test kiểu BDD và thư viện matcher dành cho team muốn dùng khối Describe/It thay vì hàm test dạng table-driven.google/go-cmp — thư viện diff mà một số team thích dùng hơn assert.Equal để so sánh struct phức tạp, mà không cần dùng tới package mock hay suite của Testify.

Câu hỏi thường gặp

Testify hỗ trợ những phiên bản Go nào?

Testify hỗ trợ các phiên bản Go chính mới nhất kể từ Go 1.19 trở đi. Đó là nội dung đúng như phần supported-versions trong README, và được cập nhật theo các bản Go mới ra sau này chứ không cố định ở một phiên bản duy nhất.

assert và require trong Testify khác nhau ở điểm nào?

Package assert của Testify trả về bool và để test chạy tiếp sau khi một check thất bại, nhờ vậy bạn có thể xâu chuỗi thêm assertion khác. require gọi cùng kiểu assertion đó nhưng dừng test ngay qua t.FailNow ngay khi có lỗi, thay vì chạy tiếp.

Package suite của Testify có hỗ trợ chạy test song song không?

Package suite của Testify không hỗ trợ chạy test song song, điều này quan trọng nếu test suite của bạn dựa vào t.Parallel() để chạy nhanh hơn. README nêu thẳng cảnh báo này và dẫn tới issue #934 đang mở trên GitHub, nơi vấn đề được theo dõi.

Testify còn được duy trì và bảo trì không?

Testify vẫn được bảo trì, nhưng chủ động giữ ở v1 — README nói rõ repo này sẽ không chấp nhận breaking change, nên các cập nhật tập trung vào sửa lỗi và tương thích thay vì tính năng mới.

Có thể dùng Testify cho mục đích thương mại theo giấy phép MIT không?

Testify được cấp phép theo giấy phép MIT, cho phép sử dụng thương mại, chỉnh sửa và phân phối lại mã nguồn, miễn là giữ nguyên văn bản giấy phép kèm theo mọi bản sao bạn phát hành hoặc đưa vào dự án thương mại của mình.

Testify v2 hiện đang ở tình trạng nào?

Testify v2 chưa được phát hành. README dẫn tới discussion #1560 trên GitHub về việc này, và cho tới khi discussion đó có kết quả rõ ràng, các package v1 trong repo này vẫn là thứ bạn cài đặt, import và dùng để viết test hằng ngày.

Vấn đề mà Testify giải quyết

testing.T thuần của Go cho bạn Errorf và Fatalf, nhưng mỗi phép so sánh bạn viết tay lại biến thành một khối if lặp đi lặp lại với thông báo lỗi phải tự định dạng, và cũng chẳng có cách nào có sẵn để mô tả những lệnh gọi kỳ vọng trên một dependency mà bạn chưa muốn chạy thật. Testify lấp cả hai khoảng trống đó. assert và require biến các check thông thường thành một lệnh gọi hàm duy nhất với output nhất quán, còn package mock cho bạn cách khai báo một dependency giả nên trả về gì mà không phải viết riêng một struct cho từng interface bạn test.

Ai nên dùng — và ai nên bỏ qua

Bất kỳ dev Go nào viết nhiều hơn vài bài test đều nên thêm Testify — assert/require sinh lợi ngay lần đầu bạn so sánh tay hai struct với nhau. Team dựa nhiều vào mocked dependency được lợi nhất, vì package mock cắt bớt rất nhiều phần boilerplate lặp lại. Nên bỏ qua, hoặc dùng dè dặt, nếu bạn cần chạy song song các subtest qua suite — package đó không hỗ trợ t.Parallel(), nên một file test nặng về suite sẽ không tận dụng được test runner song song của Go. Ai đang chờ tính năng của v2 cũng không nên chờ; repo này sẽ ở lại v1.

Repo liên quan

Nguồn & ghi công

Thông tin và ví dụ code lấy từ repository GitHub stretchr/testify và README của repo (https://github.com/stretchr/testify).

Dữ liệu GitHub · đồng bộ lần cuối 15 thg 8, 2026Đánh giá bởi Henry
← Về TopGit

Muốn nghe thêm một ý kiến về testify?

Hỏi một AI đọc được trang này — một cú bấm là có ngay nhận định về testify.

GitHub