Selama bertahun-tahun, menjalankan koleksi Postman di luar aplikasi desktop hanya berarti satu alat: Newman. Kemudian Postman merilis alat baris perintah resminya sendiri, Postman CLI, dan sekarang ada dua cara untuk melakukan hal yang kira-kira sama. Keduanya menjalankan koleksi tanpa GUI, keduanya cocok dalam pipeline CI/CD, dan keduanya menjalankan skrip pengujian yang sama. Jadi, mengapa ada dua alat, dan mana yang paling cocok untuk pipeline Anda?
Singkatnya: Newman adalah runner sumber terbuka, tanpa akun, yang telah menjadi standar komunitas sejak awal. Postman CLI adalah alat yang lebih baru, terhubung ke akun, yang menghubungkan jalankan kembali ke cloud Postman dan melaporkan hasilnya di sana. Pilihan yang tepat bergantung pada apakah Anda ingin hasil disimpan di platform Postman atau lebih memilih runner yang hanya membutuhkan file koleksi. Artikel ini membandingkan keduanya secara jujur agar Anda dapat memutuskan.
Apa itu Newman
Newman adalah runner koleksi baris perintah asli Postman. Ini adalah sumber terbuka, didistribusikan sebagai paket npm, dan sepenuhnya gratis. Ini menjalankan file koleksi yang diekspor dari Postman, mengeksekusi setiap permintaan dan setiap pernyataan pm.test, dan melaporkan hasilnya melalui kode keluarannya.
Ciri khas Newman adalah kemandiriannya. Ini tidak memerlukan akun Postman, kunci API, atau koneksi jaringan ke server Postman. Anda memberinya file koleksi JSON dan itu akan berjalan. Itu membuatnya dapat diprediksi dan mudah dipahami di lingkungan yang terkunci.
npm install -g newman
newman run checkout-api.postman_collection.json \
--environment staging.postman_environment.json
Newman juga ringan dan dapat diperluas. Ini dilengkapi dengan reporter CLI dan JUnit, dan komunitas memelihara reporter tambahan seperti newman-reporter-htmlextra untuk keluaran HTML yang kaya. Karena ini adalah paket Node.js, Anda juga dapat memanggilnya secara programatis dari skrip. Panduan kami tentang perbedaan antara Newman dan Postman mencakup bagaimana hal itu terkait dengan aplikasi desktop.
Apa itu Postman CLI
Postman CLI adalah alat baris perintah resmi yang dibangun dan kini direkomendasikan oleh Postman. Ini adalah biner tunggal yang Anda instal dengan skrip, bukan paket npm, dan terikat pada akun Postman Anda melalui kunci API.
# instal (contoh untuk macOS/Linux)
curl -o- "https://dl-cli.pstmn.io/install/osx_64.sh" | sh
# otentikasi, lalu jalankan
postman login --with-api-key YOUR_API_KEY
postman collection run checkout-api
Perbedaan utamanya adalah tautan cloud. Saat Anda menjalankan koleksi dengan Postman CLI, ia dapat menarik koleksi langsung dari ruang kerja Postman Anda berdasarkan ID, dan ia mendorong hasil jalankan kembali ke platform Postman, tempat hasil tersebut muncul di riwayat ruang kerja dan dasbor. Nilai jual utamanya adalah tata kelola API dan pemeriksaan keamanan: Postman CLI dapat menjalankan linting terhadap definisi API Anda selama pipeline, mengungkapkan pelanggaran skema dan aturan sebagai bagian dari pembangunan.
Jadi Postman CLI kurang dari sekadar runner koleksi murni dan lebih merupakan agen pipeline untuk platform Postman. Jika tim Anda bekerja di dalam cloud Postman dan menginginkan riwayat jalankan dan tata kelola terpusat di sana, integrasi itulah alasan untuk memilihnya.
Perbandingan berdampingan
| Aspek | Postman CLI | Newman |
|---|---|---|
| Sumber | Sumber tertutup, alat resmi Postman | Sumber terbuka |
| Instalasi | Skrip instalasi, biner tunggal | paket npm |
| Akun Postman | Wajib (login kunci API) | Tidak wajib |
| Sumber Koleksi | Menarik dari cloud Postman berdasarkan ID, atau file lokal | File JSON lokal |
| Hasil Jalankan | Dilaporkan kembali ke platform Postman | Output terminal dan file reporter |
| Tata kelola/linting API | Terpasang | Tidak termasuk |
| Reporter | Terbatas, hasil ada di Postman | CLI, JUnit, ditambah reporter HTML komunitas |
| Penggunaan offline | Terbatas, dirancang sekitar cloud | Sepenuhnya offline setelah file lokal |
| Kematangan | Lebih baru | Standar komunitas yang sudah lama mapan |
| Biaya | Gratis, tetapi terikat pada batasan paket Postman | Gratis, tanpa akun |
Sumbu penentu adalah cloud Postman. Postman CLI dibangun untuk menyalurkan hasil dan tata kelola ke platform Postman. Newman dibangun untuk menjalankan file dan melaporkan secara lokal, tanpa ketergantungan pada server Postman.
Bagaimana mereka cocok di CI/CD
Kedua alat ini berfungsi di penyedia CI mana pun, termasuk Jenkins, GitHub Actions, GitLab CI, dan CircleCI. Mekanismenya berbeda.
Dengan Newman, Anda melakukan commit file JSON koleksi dan lingkungan ke repositori Anda, menginstal Newman dalam pekerjaan, menjalankannya, dan membiarkan kode keluar non-nol menggagalkan build pada kegagalan pengujian. Semuanya mandiri di repo dan pipeline. Panduan kami tentang mengotomatiskan pengujian API di CI/CD dan otomatisasi pengujian API dengan GitHub Actions menunjukkan pola ini.
Dengan Postman CLI, Anda menyimpan kunci API Postman sebagai rahasia di penyedia CI, melakukan otentikasi, dan menjalankan koleksi berdasarkan ID-nya. Koleksi ditarik dari cloud Postman daripada dari repo, dan hasilnya dikirim kembali ke ruang kerja. Ini menjaga sumber kebenaran di Postman, yang disukai oleh beberapa tim dan dianggap membatasi oleh tim lain.
Perbedaan praktis: Newman menyimpan versi pengujian dengan kode Anda, karena JSON koleksi berada di repo. Postman CLI menyimpan versi pengujian di platform Postman, karena ia menarik berdasarkan ID. Putuskan sumber kebenaran mana yang diinginkan tim Anda sebelum memilih.
Sudut pandang tata kelola
Fitur tunggal yang paling jelas memisahkan kedua alat ini adalah tata kelola API. Postman CLI dapat menjalankan pemeriksaan gaya postman api lint terhadap definisi API yang tersimpan di ruang kerja Postman Anda, mengevaluasinya terhadap aturan untuk penamaan, keamanan, kelengkapan skema, dan konsistensi. Ketika pemeriksaan itu berjalan di dalam pipeline, definisi yang melanggar aturan akan menggagalkan build sebelum perubahan digabungkan.
Newman tidak memiliki padanan. Ini menjalankan koleksi dan melaporkan hasil pengujian, dan itulah batas pekerjaannya. Jika organisasi Anda peduli dengan penegakan standar desain API secara otomatis, kemampuan itu hanya ada di Postman CLI, dan itu adalah alasan nyata untuk memilihnya. Jika Anda tidak menegakkan aturan desain di pipeline, fitur tersebut tidak relevan dan kesederhanaan Newman menang.
Penting untuk jujur mengenai hal ini karena ini membingkai ulang perbandingan. Postman CLI bukan hanya "Newman, tapi lebih baru." Ini adalah jenis alat yang berbeda: agen pipeline untuk platform Postman yang kebetulan menyertakan runner koleksi. Newman adalah, dan hanya, runner koleksi. Begitu Anda melihatnya seperti itu, pilihannya menjadi kurang tentang fitur dan lebih tentang apakah Anda ingin pengujian Anda terikat pada platform Postman sama sekali.
Pertimbangan migrasi
Tim yang sudah menjalankan Newman terkadang bertanya apakah mereka harus beralih ke Postman CLI. Jarang ada alasan kuat untuk itu. Newman masih dipelihara, masih gratis, dan masih berfungsi di setiap penyedia CI. Beralih berarti menambahkan kunci API sebagai rahasia CI, mengubah cara koleksi bersumber, dan menerima ketergantungan pada cloud Postman. Kecuali Anda secara khusus menginginkan riwayat jalankan terpusat atau pemeriksaan tata kelola, biaya migrasi lebih besar daripada manfaatnya.
Tim yang baru memulai menghadapi pilihan yang lebih menarik. Jika tim berkomitmen pada Postman sebagai alat utamanya dan membayar untuk paket, Postman CLI menjaga semuanya dalam satu ekosistem dan merupakan pilihan alami. Jika tim menginginkan fleksibilitas, pengujian berversi repo, dan kebebasan dari cloud satu vendor, Newman, atau alat non-Postman sepenuhnya, lebih masuk akal. Tidak ada jawaban yang benar secara universal; hanya ada jawaban yang sesuai dengan cara kerja tim Anda saat ini.
Mana yang harus Anda pilih
Pilih Newman jika Anda menginginkan runner tanpa ketergantungan akun, jika Anda ingin pengujian divariasikan dalam repositori Anda, jika Anda memerlukan pelaporan HTML yang kaya melalui reporter komunitas, atau jika Anda menjalankannya di lingkungan terbatas di mana panggilan ke cloud Postman tidak diizinkan. Kemandirian dan kematangan Newman menjadikannya pilihan default yang aman untuk sebagian besar pipeline.
Pilih Postman CLI jika tim Anda bekerja di dalam platform Postman, jika Anda menginginkan riwayat jalankan dan dasbor terpusat di sana, atau jika tata kelola API dan linting definisi dalam pipeline bernilai bagi Anda. Integrasi cloud-nya yang erat adalah keuntungan nyata bagi tim yang berpusat pada Postman.
Jika Anda sedang mempertimbangkan keputusan ini, ada baiknya bertanya apakah Anda ingin terikat pada ekosistem Postman sama sekali. Untuk pendekatan lain, lihat panduan kami tentang menjalankan koleksi Postman di CI tanpa Newman dan pandangan kami yang lebih luas tentang pengujian API tanpa Postman.
Alternatif alat tunggal: Apidog
Baik Postman CLI maupun Newman berasumsi Anda membuat pengujian di Postman. Apidog menghilangkan pemisahan itu. Anda mendesain API, men-debug permintaan, dan membangun skenario pengujian otomatis dengan pernyataan visual dalam satu aplikasi, lalu menjalankan skenario tersebut di CI/CD dengan runner baris perintah bawaan. Tidak ada langkah ekspor dan tidak ada paket runner terpisah, karena definisi pengujian dan mesin eksekusi adalah produk yang sama.
Apidog juga menggabungkan desain API, server mock, dan pengujian kinerja, sehingga tim dapat mencakup seluruh siklus hidup API tanpa menyatukan alat-alat. Anda dapat mengunduh Apidog dan menggunakan fitur pengujiannya secara gratis, termasuk runner CLI untuk pipeline.
Pertanyaan yang sering diajukan
Apakah Postman CLI menggantikan Newman?
Postman memposisikan Postman CLI sebagai alat baris perintah yang direkomendasikan secara resmi, tetapi Newman masih dipelihara dan banyak digunakan. Newman tetap menjadi pilihan yang lebih baik ketika Anda menginginkan runner tanpa akun, dengan versi di repo. Keduanya kemungkinan akan hidup berdampingan untuk beberapa waktu, jadi tidak ada kebutuhan mendesak untuk migrasi.
Apakah Postman CLI memerlukan akun Postman?
Ya. Postman CLI melakukan otentikasi dengan kunci API Postman dan dirancang untuk menghubungkan jalankan kembali ke ruang kerja Postman Anda. Newman, sebaliknya, tidak memerlukan akun dan berjalan murni dari file koleksi lokal.
Alat mana yang memberikan laporan lebih baik?
Newman memiliki pelaporan yang lebih fleksibel melalui reporter komunitas, terutama newman-reporter-htmlextra untuk keluaran HTML yang terperinci dan JUnit XML untuk dasbor CI. Postman CLI melaporkan hasil ke platform Postman itu sendiri, yang nyaman jika tim Anda bekerja di sana tetapi kurang fleksibel untuk file laporan mandiri.
Bisakah Postman CLI menjalankan file koleksi lokal?
Postman CLI dapat menjalankan koleksi dari file lokal, tetapi dibangun di sekitar penarikan koleksi dari cloud Postman berdasarkan ID dan pelaporan hasil kembali. Jika Anda menginginkan alat yang memperlakukan file JSON lokal sebagai sumber kebenaran tanpa keterlibatan cloud, Newman lebih alami sesuai dengan model tersebut.
Mana yang lebih cepat di CI?
Untuk eksekusi koleksi murni, perbedaannya kecil dan bergantung pada ukuran koleksi serta kondisi jaringan. Newman memiliki jejak yang lebih kecil dan tanpa perjalanan pulang-pergi cloud. Postman CLI menambahkan overhead otentikasi dan sinkronisasi hasil ke platform. Untuk sebagian besar pipeline, pilihlah berdasarkan kesesuaian alur kerja daripada kecepatan mentah.