Contract testing memverifikasi bahwa dua layanan sepakat pada API mereka tanpa menjalankannya bersama dalam tes integrasi penuh. Dalam consumer-driven contracts (CDC), konsumen mendefinisikan apa yang dibutuhkannya, dan penyedia memverifikasi bahwa dapat memberikannya.
Tes end-to-end penuh di berbagai layanan lambat, tidak stabil, dan sulit dijalankan pada setiap commit. Contract tests menangkap perubahan API yang merusak sejak dini, secara terisolasi.
1. Consumer writes expectations ─▶ generates a CONTRACT (Pact file)
2. Contract published to a broker
3. Provider runs the contract against itself in its own pipeline
4. Provider build FAILS if it would break the consumer
// consumer declares exactly what it expects from the provider
provider.given('order 42 exists')
.uponReceiving('a request for order 42')
.withRequest({ method: 'GET', path: '/orders/42' })
.willRespondWith({
status: 200,
body: { id: '42', total: 99.5 } // the shape the consumer relies on
});
CI penyedia memutar ulang ini dan gagal jika tidak lagi mengembalikan bentuk tersebut.
| Contract test | Integration test | |
|---|---|---|
| Layanan berjalan | Satu per satu | Semua bersama |
| Kecepatan | Cepat | Lambat |
| Menangkap | Contract breaks | Masalah wiring nyata |
Contract tests memberikan kepercayaan bahwa perubahan penyedia tidak akan merusak konsumen, tanpa biaya dan ketidakstabilan spinning up seluruh sistem.
Mereka membuat deployment independen aman: pipeline setiap tim tahu segera jika perubahannya akan melanggar kontrak yang diketahui oleh seseorang.