Bagaimana anda menambah ujian kepada kod legasi?

Question

Accepted Answer

**Kod legasi** (selalunya tidak diuji, sukar diubah) adalah mencabar untuk diuji — ia mungkin mempunyai dependency yang berbelit dan tiada ujian. Menambah ujian dengan selamat melibatkan teknik seperti **characterization test**, **seam** untuk memecahkan dependency, dan penambahbaikan secara berperingkat, membolehkan perubahan yang lebih selamat.

## Cabaran kod legasi

```text
Legacy code is often: untested, tightly coupled, hard to understand, risky to change:
  → no tests → changing it is dangerous (you can't tell if you broke something)
  → hard to test → dependencies are tangled (can't isolate units); not designed for testing
→ a chicken-and-egg problem: to change safely you need tests, but it's hard to test.
```

## Characterization test (memaku tingkah laku semasa)

```text
CHARACTERIZATION (golden master) tests → capture the code's CURRENT behavior as-is
  (even if you don't fully understand it / it has bugs):
  → write tests asserting what it ACTUALLY does now → a SAFETY NET
  → then you can refactor/change with confidence that behavior is preserved
→ Don't assert what it SHOULD do — assert what it DOES, to protect against regressions.
```

## Memecahkan dependency (seam)

```text
To isolate hard-to-test code, find/create SEAMS (places to substitute dependencies):
  → extract dependencies behind interfaces; inject them; use the smallest safe refactors
    to make code testable (Michael Feathers' techniques)
  → carefully break dependencies so you can get the code under test, then test, then refactor
```

## Pendekatan berperingkat

```text
✓ Add tests AROUND code BEFORE changing it (a safety net for the change)
✓ Focus on areas you're CHANGING / high-risk / high-value (not the whole codebase at once)
✓ Improve incrementally — leave code a bit better each time (the "boy scout rule")
✓ Use characterization tests to capture behavior, then refactor toward testability
```

## Mengapa ia penting

Memahami cara menambah ujian kepada kod legasi adalah pengetahuan peringkat senior yang berharga kerana **kebanyakan kerja dunia nyata melibatkan kod sedia ada yang selalunya tidak diuji**, dan menambah baiknya dengan selamat ialah cabaran lazim yang penting, jadi ia relevan secara praktikal.

Kod legasi (tidak diuji, terikat rapat, sukar diubah) menghadirkan **masalah ayam-dan-telur** sebenar: untuk mengubahnya dengan selamat anda memerlukan ujian, tetapi ia sukar untuk diuji (dependency berbelit, tidak direka untuk pengujian) — dan mengubah kod yang tidak diuji adalah berbahaya kerana anda tidak dapat mengetahui sama ada anda merosakkan sesuatu.

Memahami teknik untuk menangani ini adalah pengetahuan praktikal yang berharga. **Characterization test** (menangkap tingkah laku *semasa* kod seadanya, mengesahkan apa yang sebenarnya dilakukannya dan bukan apa yang sepatutnya — walaupun tidak difahami sepenuhnya) menyediakan **jaring keselamatan** yang membolehkan anda melakukan refactor dan perubahan dengan yakin bahawa tingkah laku sedia ada dikekalkan — satu teknik utama untuk bekerja dengan kod yang anda tidak fahami sepenuhnya.

Memahami **memecahkan dependency melalui seam** (mencari atau mencipta tempat untuk menggantikan dependency, menggunakan refactor selamat minimum untuk menjadikan kod yang berbelit boleh diuji — teknik daripada kerja Michael Feathers tentang kod legasi) adalah penting untuk membawa kod yang sukar diuji ke bawah ujian.

Memahami **pendekatan berperingkat** — menambah ujian di sekitar kod sebelum mengubahnya (jaring keselamatan untuk perubahan), memfokus pada kawasan yang sedang diubah atau berisiko tinggi/bernilai tinggi (bukan keseluruhan codebase sekaligus), dan menambah baik secara berperingkat (boy scout rule) — mencerminkan cara pragmatik dan realistik untuk menambah baik sistem legasi dari semasa ke semasa.

Memandangkan kebanyakan pembangunan dunia nyata melibatkan kod legasi sedia ada yang selalunya tidak diuji yang mesti diubah dengan selamat (situasi lazim dan mencabar), dan memandangkan memahami teknik (characterization test untuk jaring keselamatan, seam untuk memecahkan dependency, penambahbaikan berperingkat) membolehkan melakukan ini, memahami cara menambah ujian kepada kod legasi adalah pengetahuan peringkat senior yang berharga — relevan secara praktikal untuk realiti lazim bekerja dengan kod sedia ada yang tidak diuji, mencerminkan pengalaman dan teknik yang diperlukan untuk menambah baik sistem legasi dengan selamat, satu kompetensi penting untuk jurutera senior yang kerap perlu menjadikan kod tidak diuji lebih selamat untuk diubah.