Mengoptimalkan Postman: Panduan Lengkap Otomatisasi Tes Postman dengan Newman

Artikel ini akan mendalami bagaimana Newman memberikan kehidupan pada skrip Postman melalui eksekusi baris perintah, dengan menjelaskan perintah dan parameter kuncinya untuk pengujian API yang efisien.

Dalam dunia pengembangan perangkat lunak, peralatan pengujian yang efisien sangat penting. Postman, dengan antarmuka grafis yang ramah pengguna, telah menjadi pilihan utama untuk pengujian API, sementara pendamping baris perintahnya, Newman, menawarkan fleksibilitas lebih dalam automasi. Artikel ini akan mendalami bagaimana Newman memberikan kehidupan pada skrip Postman melalui eksekusi baris perintah, dengan menjelaskan perintah dan parameter kuncinya untuk pengujian API yang efisien.

Postman.png

Memahami Peran Newman dalam Pengujian API

Secara esensial, Newman adalah Runner Koleksi baris perintah untuk Postman. Ia memungkinkan Anda menjalankan dan menguji koleksi langsung dari baris perintah, menjadikannya alat yang tak tergantikan untuk pipeline integrasi dan pengiriman terus-menerus (CI/CD). Dengan Newman, para penguji dan pengembang dapat mengotomatiskan pengujian web API tanpa GUI Postman, mengintegrasikan tes ini dengan sistem build dan repositori kontrol versi mereka.

Newman.png

Perintah dan Parameter Utama

Perintah untuk Menjalankan Koleksi

Untuk mengeksekusi koleksi Postman melalui Newman, gunakan perintah dasar berikut:

newman run [collection.json]

Perintah ini memulai proses menjalankan koleksi yang ditentukan.

Parameter yang Sering Digunakan

Newman memungkinkan Anda untuk mengonfigurasi lebih lanjut eksekusi koleksi dengan beberapa opsi:

  • -e, --environment <path>: Menentukan jalur file ke file lingkungan Postman. Ini memungkinkan Newman menggunakan variabel lingkungan dari file yang diberikan.
  • -g, --globals <path>: Menunjukkan jalur ke file global Postman, memberikan akses Newman ke variabel global.
  • -d, --iteration-data <path>: Menunjuk ke file data yang akan digunakan untuk menjalankan iterasi koleksi. Berguna untuk pengujian berbasis data.
  • -n, --iteration-count <number>: Mengizinkan Anda menentukan berapa kali koleksi dijalankan.
  • -r, --reporters [names]: Menentukan format output untuk laporan pengujian (cli, html, json, junit, dll). Misalnya, --reporter-html-export dapat mengarahkan output ke file HTML.

Panduan Implementasi Dunia Nyata

Langkah 1: Mengekspor Data Postman Anda

1. Ekspor Koleksi: Klik kanan koleksi di Postman dan pilih "Ekspor" untuk menyimpannya sebagai testcase.json.

Export Collection.jpg

2.Ekspor Lingkungan: Di Postman, ekspor lingkungan apa pun yang Anda gunakan menjadi environment.json.

Export Environment.jpg

3. Ekspor Variabel Global: Demikian pula, ekspor variabel global apapun menjadi globals.json.

Export Global Variables.jpg

4. Menyiapkan File Data: Jika tes Anda menggunakan data eksternal, ekspor ini ke data.json.

Langkah 2: Menjalankan Koleksi Anda dengan Newman

Navigasikan ke direktori yang berisi file ekspor Anda dan jalankan perintah berikut:

newman run testcase.json -e environment.json -g globals.json -d data.json -r cli,html,json,junit --reporter-html-export report.html
reporter.jpg

Mengeksekusi perintah ini akan menjalankan koleksi menggunakan file lingkungan dan data yang ditentukan, menjalankan pengujian sesuai definisi, dan menghasilkan laporan tes yang rinci dalam format yang Anda pilih, termasuk laporan yang disimpan lokal.

report.png

Memahami Hasil

Laporan yang dihasilkan Newman menawarkan wawasan berharga tentang performa pengujian API:

  • Statistik Aseri: Jumlah aseri dan status lulus/tidak lulus mereka.
  • Waktu Laporan Tes: Total waktu yang diperlukan untuk mengeksekusi tes.
  • Kecepatan Tanggapan: Ikhtisar cepat dari waktu respons.
  • Waktu Respons Rata-rata: Berguna untuk memahami performa dan kondisi kesehatan API Anda.
report.jpg

Kesimpulan

Newman mengubah koleksi Postman menjadi suite tes otomatis yang kuat yang cocok dalam alur kerja pengembangan apa pun, khususnya ketika pengujian berkelanjutan sangat penting. Dengan memanfaatkan kemampuan baris perintah Newman, tim dapat melakukan pengujian API secara rinci dengan mudah dan efisien, memastikan kualitas perangkat lunak yang tinggi dengan setiap build. Mengintegrasikan Newman ke dalam pipa pengembangan Anda bukan hanya tentang mengotomatiskan tes; ini tentang mengamankan lingkungan pengujian yang dapat diandalkan, dapat diskalakan, dan mulus.