Postman adalah alat yang sangat berguna untuk mengembangkan dan menguji API. Salah satu fitur paling kuat dari Postman adalah kemampuan untuk menjalankan pengujian otomatis menggunakan Postman Collection Runner. Artikel ini akan membahas cara menggunakan Postman Runner untuk menjalankan tes API, mengelola variabel, dan menghasilkan laporan pengujian.
Apa Itu Postman Collection Runner?
Postman Collection Runner adalah fitur yang memungkinkan pengguna untuk menjalankan serangkaian permintaan API yang telah dikelompokkan dalam sebuah koleksi (collection). Ini sangat berguna untuk pengujian otomatis, pengujian regresi, dan untuk memastikan bahwa API Anda berfungsi dengan baik setelah perubahan atau pembaruan.
Mengapa Menggunakan Postman Runner?
- Automasi: Memungkinkan eksekusi otomatis dari serangkaian permintaan API.
- Pengujian Regresi: Menjalankan tes berulang kali untuk memastikan perubahan kode tidak memperkenalkan bug baru.
- Data-driven Testing: Menggunakan data eksternal untuk menggerakkan pengujian dengan berbagai input.
- Laporan Pengujian: Menghasilkan laporan pengujian yang rinci untuk analisis hasil pengujian.
Langkah-langkah Menjalankan Test dengan Postman Runner
1. Membuat Koleksi di Postman
Langkah pertama adalah membuat koleksi yang berisi permintaan API yang ingin Anda uji.
- Buka Postman dan buat tab request baru.
- Masukkan URL endpoint API yang ingin diuji.
- Pilih metode HTTP yang sesuai (GET, POST, PUT, DELETE, dll.).
- Tambahkan parameter, header, atau body jika diperlukan.
- Klik tombol "Save" untuk menyimpan request dalam koleksi baru atau yang sudah ada.
2. Menambahkan Assertion dalam Test
Tambahkan skrip uji dalam tab "Tests" pada setiap request untuk memverifikasi respons API.
Contoh assertion dasar untuk memeriksa status kode:
3. Menggunakan Postman Collection Runner
Untuk menjalankan tes menggunakan Collection Runner:
- Buka Postman dan klik ikon "Runner" di sudut kiri atas.
- Di jendela Collection Runner, pilih koleksi yang ingin Anda jalankan.
- Jika Anda menggunakan file data untuk pengujian yang digerakkan oleh data, impor file data (CSV atau JSON) menggunakan tombol "Select File".
- Tentukan jumlah iterasi yang diinginkan, misalnya, berapa kali Anda ingin menjalankan koleksi.
- Klik tombol "Run" untuk memulai pengujian.
4. Mengelola Variabel dalam Pengujian
Postman memungkinkan penggunaan variabel untuk menyimpan dan menggunakan nilai secara dinamis selama pengujian.
- Variabel Lingkungan (Environment Variables): Digunakan untuk menyimpan nilai yang berbeda untuk berbagai lingkungan (misalnya, dev, staging, prod).
- Variabel Koleksi (Collection Variables): Digunakan untuk menyimpan nilai yang berlaku untuk seluruh koleksi.
- Variabel Global (Global Variables): Digunakan untuk menyimpan nilai yang dapat diakses dari mana saja dalam Postman.
Contoh penggunaan variabel dalam URL request:
Anda dapat mengatur variabel base_url dalam lingkungan atau koleksi.
5. Menghasilkan Laporan Pengujian
Setelah menjalankan tes dengan Collection Runner, Postman akan menghasilkan laporan yang menampilkan hasil setiap permintaan dalam koleksi.
- Laporan Ringkas: Menampilkan jumlah tes yang lulus dan gagal.
- Laporan Detail: Menampilkan detail hasil untuk setiap permintaan, termasuk waktu respons dan hasil assertion.
Anda dapat mengekspor hasil pengujian ke format JSON untuk analisis lebih lanjut atau dokumentasi.
6. Mengotomatisasi Pengujian dengan Newman
Untuk menjalankan koleksi Postman di luar Postman (misalnya, dalam sistem CI/CD), Anda dapat menggunakan Newman, command-line tool untuk Postman.
Install Newman:
Jalankan Koleksi dengan Newman:
Newman memungkinkan integrasi mudah dengan alat CI/CD seperti Jenkins, GitLab CI, dan lainnya, memungkinkan pengujian otomatis yang dapat diatur untuk berjalan pada setiap build atau deploy.
Kesimpulan
Postman Collection Runner adalah alat yang sangat kuat untuk menjalankan pengujian API secara otomatis. Dengan menggunakan Collection Runner, Anda dapat memastikan bahwa API Anda berfungsi dengan baik setelah setiap perubahan, melakukan pengujian berbasis data, dan menghasilkan laporan pengujian yang berguna. Untuk pengujian yang lebih canggih dan integrasi dengan pipeline CI/CD, Anda dapat menggunakan Newman untuk menjalankan koleksi Postman dari command-line.