1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
|
= Membuat sebuah tes
Sekarang setelah kode kita menjadi stabil, tambahkan sebuah tes.
Menguji kode Anda selama pengembangan dapat menangkap _bug_ yang mungkin
terjadi saat perubahan dilakukan.
Dalam topik ini, kita akan menambahkan sebuah tes untuk fungsi `Hello`.
NOTE: Topik ini adalah bagian dari seri tutorial yang dimulai dengan
link:/doc/tutorial/create-module/[Membuat sebuah Go modul^].
Dukungan bawaan Go untuk unit tes membuat pengembang mudah membuat dan
melakukan tes.
Khususnya, dengan konvensi penamaan, paket "testing", dan perintah "go test",
kita dapat dengan cepat menulis dan mengeksekusi tes.
. Dalam direktori "greetings", buatlah sebuah berkas bernama
"greetings_test.go"
+
--
Dengan mengakhiri sebuah nama berkas dengan "_test.go" berarti memberitahu
perintah "go test" bahwa berkas tersebut berisi fungsi-fungsi tes.
--
. Dalam "greetings_test.go", salin lah kode berikut ke dalam berkas dan
simpan.
+
--
----
package greetings
import (
"testing"
"regexp"
)
// TestHelloName memanggil greetings.Hello dengan sebuah nama, memeriksa
// kembalian yang valid.
func TestHelloName(t *testing.T) {
name := "Gladys"
want := regexp.MustCompile(`\b`+name+`\b`)
msg, err := Hello("Gladys")
if !want.MatchString(msg) || err != nil {
t.Fatalf(`Hello("Gladys") = %q, %v, want match for %#q, nil`, msg, err, want)
}
}
// TestHelloEmpty memanggil greetings.Hello dengan string kosong,
// memeriksa jika ada eror.
func TestHelloEmpty(t *testing.T) {
msg, err := Hello("")
if msg != "" || err == nil {
t.Fatalf(`Hello("") = %q, %v, want "", error`, msg, err)
}
}
----
Dalam kode tersebut, kita:
* Mengimplementasikan fungsi tes dalam paket yang sama dengan kode yang akan
kita uji.
* Membuat dua fungsi tes untuk menguji fungsi "greetings.Hello".
Nama fungsi untuk tes haruslah dengan format `Test__Nama__`, yang mana
__Nama__ menyatakan apa yang akan diuji.
Fungsi-fungsi tes menerima sebuah pointer ke
https://pkg.go.dev/testing#T[tipe `testing.T`^]
sebagai parameter.
Kita menggunakan method-method pada parameter ini untuk melaporkan dan
mencatat hasil dari pengujian.
* Mengimplementasikan dua tes:
** `TestHelloName` memanggil fungsi `Hello` dengan mengirim sebuah nama.
Fungsi tersebut seharusnya mengembalikan sebuah pesan yang valid.
Jika pemanggilan mengembalikan eror atau sebuah pesan respon yang tidak
diharapkan (misalnya pesan yang tidak berisi nama), kita akan gunakan
https://pkg.go.dev/testing#T.Fatalf[method `Fatalf`^]
pada parameter `t` untuk mencetak sebuah pesan ke layar dan mengakhiri
pengujian.
** `TestHelloEmpty` memanggil fungsi `Hello` dengan string kosong.
Tes ini dirancang untuk mengonfirmasi bahwa penanganan eror berjalan dengan
benar.
Jika kembalian dari fungsi `Hello` berupa string yang tidak kosong tanpa ada
eror, kita panggil method `Fatalf` dari parameter `t` untuk mencetak pesan dan
mengakhiri pengujian.
--
. Dari _terminal_, dalam direktori "greetings", jalankan
link:/cmd/go/#hdr-Test_packages[perintah `go test`^]
untuk mengeksekusi tes.
+
--
Perintah "go test" mengeksekusi fungsi-fungsi tes (yang namanya dimulai dengan
`Test`) dalam berkas-berkas tes (yang namanya berakhir dengan `_test.go`).
Anda dapat menambahkan opsi `-v` untuk menampilkan pesan tambahan yang
mencetak semua fungsi tes dan hasilnya.
Pengujian seharusnya berhasil dengan sukses.
----
$ 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
----
--
. Ganti fungsi "greetings.Hello" supaya tes gagal.
+
--
Fungsi tes `TestHelloName` memeriksa nilai kembalian berdasarkan nama yang
kita kirim sebagai parameter ke fungsi `Hello`.
Untuk dapat melihat hasil tes yang gagal, ubah fungsi "greetings.Hello" supaya
mengembalikan pesan tanpa nama.
Dalam "greetings/greetings.go", salin lah kode berikut mengganti fungsi
`Hello` yang sudah ada.
Kode yang baru ini mengganti nilai yang dikembalikan oleh fungsi, anggap
seperti argumen nama secara tidak sengaja dihapus.
----
// Hello mengembalikan sebuah salam untuk nama seseorang.
func Hello(name string) (string, error) {
// Jika nama kosong, kembalikan sebuah eror dengan pesan.
if name == "" {
return name, errors.New("empty name")
}
// Buat sebuah pesan dengan format yang acak.
// message := fmt.Sprintf(randomFormat(), name)
message := fmt.Sprint(randomFormat())
return message, nil
}
----
--
. Pada _terminal_, di dalam direktori "greetings", jalankan "go test" untuk
mengeksekusi tes.
+
--
Kali ini, jalankan "go test" tanpa opsi `-v`.
Keluaran dari perintah tersebut berupa hasil tes yang gagal, yang berguna bila
kita memiliki banyak tes.
Tes pada `TestHelloName` seharusnya gagal, sementara `TestHelloEmpty` tetap
berhasil.
----
$ 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
----
--
Pada topik selanjutnya (dan yang terakhir), kita akan melihat bagaimana
mengompilasi dan memasang kode supaya dapat dijalankan secara lokal.
Lanjut: link:/doc/tutorial/compile-install/[Mengompilasi dan memasang
aplikasi].
Balik: link:/doc/tutorial/greetings-multiple-people/[Mengembalikan salam untuk
beberapa orang].
|
