httptest — menguji handler & klien

httptest membuat tes HTTP di Go murah: satu permintaan palsu, satu perekam respons, tanpa port dan tanpa menunggu. Itulah alasan tes tingkat handler layak ditulis untuk hampir setiap endpoint.

Menguji satu handler

func TestAmbilProduk(t *testing.T) {
	h := New(layananUji(t), slog.Default())

	req := httptest.NewRequest(http.MethodGet, "/api/v1/produk/1", nil)
	rec := httptest.NewRecorder()

	// Lewat ROUTER, bukan h.AmbilProduk(rec, req) langsung — supaya
	// middleware, parameter jalur, dan otorisasi ikut teruji.
	h.Rute().ServeHTTP(rec, req)

	if rec.Code != http.StatusOK {
		t.Fatalf("status = %d, mau 200; body: %s", rec.Code, rec.Body)
	}
	if ct := rec.Header().Get("Content-Type"); !strings.HasPrefix(ct, "application/json") {
		t.Errorf("Content-Type = %q", ct)
	}

	var got produkResp
	if err := json.Unmarshal(rec.Body.Bytes(), &got); err != nil {
		t.Fatalf("body bukan JSON valid: %v", err)
	}
	if got.Nama != "Kopi Arabika" {
		t.Errorf("nama = %q, mau %q", got.Nama, "Kopi Arabika")
	}
}

Permintaan dengan body dan autentikasi

func TestBuatProduk(t *testing.T) {
	h := New(layananUji(t), slog.Default())

	body := strings.NewReader(`{"nama":"Kopi Robusta","harga":45000}`)
	req := httptest.NewRequest(http.MethodPost, "/api/v1/produk", body)
	req.Header.Set("Content-Type", "application/json")
	req.AddCookie(&http.Cookie{Name: "sesi", Value: sesiUji(t, 1)})

	rec := httptest.NewRecorder()
	h.Rute().ServeHTTP(rec, req)

	if rec.Code != http.StatusCreated {
		t.Fatalf("status = %d, mau 201; body: %s", rec.Code, rec.Body)
	}
	if loc := rec.Header().Get("Location"); loc == "" {
		t.Error("header Location kosong")
	}
}

Tes otorisasi — yang paling penting

func TestPenggunaTidakBisaMembacaMilikOrangLain(t *testing.T) {
	h := New(layananUji(t), slog.Default())

	// Faktur 100 milik pengguna 1.
	req := httptest.NewRequest(http.MethodGet, "/api/v1/faktur/100", nil)
	req.AddCookie(&http.Cookie{Name: "sesi", Value: sesiUji(t, 2)})   // pengguna 2

	rec := httptest.NewRecorder()
	h.Rute().ServeHTTP(rec, req)

	if rec.Code != http.StatusNotFound {
		t.Fatalf("pengguna lain dapat status %d, mau 404; body: %s",
			rec.Code, rec.Body)
	}
}

func TestDaftarHanyaMilikSendiri(t *testing.T) {
	// Yang paling sering terlewat: endpoint DETAIL sudah aman,
	// endpoint DAFTAR masih mengembalikan semua baris.
	req := httptest.NewRequest(http.MethodGet, "/api/v1/faktur", nil)
	req.AddCookie(&http.Cookie{Name: "sesi", Value: sesiUji(t, 2)})

	rec := httptest.NewRecorder()
	h.Rute().ServeHTTP(rec, req)

	var hasil struct{ Data []fakturResp }
	_ = json.Unmarshal(rec.Body.Bytes(), &hasil)

	for _, f := range hasil.Data {
		if f.PenggunaID != 2 {
			t.Fatalf("daftar memuat faktur milik pengguna %d", f.PenggunaID)
		}
	}
}

Menguji klien HTTP

func TestKlienPembayaran(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(
		func(w http.ResponseWriter, r *http.Request) {
			// Periksa juga apa yang DIKIRIM klienmu
			if got := r.Header.Get("Authorization"); got != "Bearer rahasia" {
				t.Errorf("Authorization = %q", got)
			}
			if r.URL.Path != "/pembayaran/abc" {
				t.Errorf("path = %q", r.URL.Path)
			}
			w.Header().Set("Content-Type", "application/json")
			_, _ = w.Write([]byte(`{"status":"lunas","jumlah":45000}`))
		}))
	t.Cleanup(srv.Close)

	k := NewKlienPembayaran(srv.URL, srv.Client(), "rahasia")

	s, err := k.Status(t.Context(), "abc")
	if err != nil {
		t.Fatalf("Status() error = %v", err)
	}
	if s.Status != "lunas" {
		t.Errorf("status = %q, mau %q", s.Status, "lunas")
	}
}

Menguji jalur kegagalan

func TestKlienSaatTimeout(t *testing.T) {
	srv := httptest.NewServer(http.HandlerFunc(
		func(w http.ResponseWriter, r *http.Request) {
			<-r.Context().Done()      // tidak pernah menjawab
		}))
	t.Cleanup(srv.Close)

	k := NewKlienPembayaran(srv.URL, srv.Client(), "rahasia")

	ctx, batal := context.WithTimeout(t.Context(), 100*time.Millisecond)
	defer batal()

	if _, err := k.Status(ctx, "abc"); !errors.Is(err, context.DeadlineExceeded) {
		t.Errorf("err = %v, mau DeadlineExceeded", err)
	}
}

Menghitung kueri per permintaan

// Pagar terhadap N+1 (Fase 4): kalau jumlah kueri naik seiring
// jumlah baris, tesnya gagal.
func TestDaftarTidakNPlus1(t *testing.T) {
	db, hitung := dbBerhitung(t)
	h := New(layananDengan(db), slog.Default())

	buatProduk(t, db, 50)

	hitung.Reset()
	req := httptest.NewRequest(http.MethodGet, "/api/v1/produk?batas=50", nil)
	h.Rute().ServeHTTP(httptest.NewRecorder(), req)

	if n := hitung.Jumlah(); n > 3 {
		t.Errorf("daftar 50 produk memakai %d kueri, mau ≤ 3", n)
	}
}