Cara Menetapkan Variabel di Skrip Post-Request Postman

Pengujian API yang efektif memerlukan pengelolaan data yang dinamis. Skrip pasca-permintaan Postman menawarkan mekanisme yang kuat untuk mencapai ini melalui pengaturan variabel. Dengan secara strategis menangkap dan menyimpan nilai dari respons API, penguji dapat meningkatkan efisiensi pengujian, kemampuan pemeliharaan, dan keandalan.

Artikel ini membahas seluk-beluk penggunaan kemampuan skrip Postman untuk mengatur variabel. Ini akan memberikan panduan komprehensif tentang penggunaan fungsi pm.environment.set() dan pm.globals.set() untuk membuat dan mengelola variabel dalam cakupan yang berbeda. Contoh praktis akan menggambarkan cara mengekstrak data dari respons API dan menetapkannya ke variabel untuk digunakan selanjutnya dalam kasus pengujian.

Apa itu Skrip Pasca-Permintaan?

Skrip pasca-permintaan adalah cuplikan kode JavaScript yang dieksekusi setelah Postman mengirim permintaan dan menerima respons. Mereka menyediakan cara yang ampuh untuk berinteraksi dengan data respons, melakukan pernyataan, mengekstrak informasi, dan memanipulasi data untuk permintaan berikutnya.

Pada dasarnya, mereka memungkinkan Anda untuk mengotomatiskan berbagai tugas pengujian dan penanganan data dalam lingkungan Postman.

Panduan Langkah demi Langkah tentang Cara Mengatur Variabel dalam Skrip Pasca-Permintaan Postman

Langkah 1 - Akses Tab Skrip Pasca-Permintaan:

Pertama, buka API atau permintaan yang ingin Anda edit, dan klik tab Scripts. Di sinilah Anda dapat menemukan bagian Post-response.

Langkah 2 - Ekstrak Data dari Respons Postman

Gunakan metode pm.response.json() atau pm.response.text() untuk mengakses isi respons API sebagai JSON atau teks.

Selama langkah ini, Anda juga harus menggunakan objek JavaScript atau teknik manipulasi string yang diperlukan untuk mengekstrak data yang diinginkan.

Langkah 3 - Atur Variabel

Anda harus menggunakan pm.environment.set(), pm.globals.set(), atau pm.collectionVariables.set() untuk menyimpan data yang diekstrak dalam variabel. Pilihan tergantung pada cakupan yang diinginkan.

Contoh Pengaturan Variabel dalam Skrip Pasca-Permintaan Postman

pm.test("Set a variable", () => {
    const jsonData = pm.response.json();
    const token = jsonData.access_token;
    pm.environment.set("auth_token", token);
});

Cuplikan kode ini mengekstrak access_token dari respons JSON dan menyimpannya dalam variabel lingkungan bernama auth_token.

Tips Tambahan

• Penanganan Kesalahan: Terapkan penanganan kesalahan untuk menangani format respons yang tidak terduga atau data yang hilang.
• Tipe Data: Pastikan tipe data yang benar untuk variabel. Gunakan operator typeof untuk memeriksa.
• Penggunaan Variabel: Akses variabel dalam permintaan berikutnya menggunakan kurung kurawal ganda: {{auth_token}}.
• Praktik Terbaik: Pertimbangkan untuk menggunakan nama variabel deskriptif dan mengatur skrip Anda untuk keterbacaan yang lebih baik.

Keuntungan Mengatur Variabel dalam Skrip Pasca-Permintaan Postman

Data Uji Dinamis

Data waktu nyata: Tangkap dan simpan data dinamis dari respons API (misalnya, ID, token, stempel waktu) untuk penggunaan langsung dalam permintaan berikutnya.

Pengujian berbasis data: Buat pengujian yang lebih kuat dengan menggunakan data aktual dari sistem daripada nilai statis.

Penggunaan Kembali Data Uji

Efisiensi: Gunakan kembali data yang ditangkap di beberapa permintaan dalam koleksi atau lingkungan, mengurangi entri data manual dan potensi kesalahan.

Korelasi: Tautkan permintaan yang bergantung dengan meneruskan data dari satu respons ke respons lainnya, meningkatkan akurasi pengujian.

Pemeliharaan Pengujian

Fleksibilitas: Mudah memodifikasi nilai variabel tanpa mengubah beberapa isi permintaan, membuat pembaruan pengujian lebih efisien.

Sentralisasi: Kelola data pengujian di lokasi terpusat (variabel lingkungan atau global) untuk organisasi yang lebih baik.

Skenario Pengujian Kompleks

Manipulasi data: Proses dan ubah data yang ditangkap sebelum menyimpannya sebagai variabel, memungkinkan logika pengujian yang kompleks.

Logika bersyarat: Gunakan variabel dalam pernyataan bersyarat untuk mengontrol alur pengujian berdasarkan data respons.

Kolaborasi

Data bersama: Bagikan variabel lingkungan atau global di antara anggota tim untuk mempertahankan data pengujian yang konsisten.

Manajemen lingkungan: Buat lingkungan yang berbeda dengan nilai variabel yang bervariasi untuk skenario pengujian yang berbeda.

Kasus Penggunaan Umum untuk Mengatur Variabel dalam Skrip Pasca-Permintaan Postman

Mengatur variabel dalam skrip pasca-permintaan Postman adalah teknik serbaguna dengan banyak aplikasi dalam pengujian API. Berikut adalah beberapa kasus penggunaan umum:

• Manajemen token otentikasi: Ekstrak token akses dari respons otentikasi dan simpan untuk permintaan berikutnya.
• Penanganan data dinamis: Tangkap dan simpan data dinamis seperti ID pengguna, nomor pesanan, atau ID sesi untuk korelasi data pengujian.
• Pengujian berbasis data: Hasilkan data pengujian secara dinamis dan simpan dalam variabel untuk pengujian berulang.
• Penanganan kesalahan: Simpan pesan atau kode kesalahan untuk analisis atau pelaporan lebih lanjut.
• Pengujian kinerja: Ukur waktu respons dan simpan untuk analisis.
• Merantai permintaan: Meneruskan data dari satu permintaan ke permintaan lain, membuat alur pengujian yang kompleks.
• Manajemen lingkungan: Simpan nilai konfigurasi khusus lingkungan seperti URL dasar atau kunci API.
• Pembuatan data pengujian: Buat data acak atau berurutan untuk kasus pengujian.
• Logika khusus: Terapkan logika khusus berdasarkan data respons, seperti eksekusi bersyarat atau transformasi data.

Apidog - Alat Pengembangan API All-In-One

Apidog adalah alat API komprehensif yang memberi pengguna fungsionalitas lengkap untuk seluruh siklus hidup API. Ini mengkhususkan diri dalam antarmuka pengguna yang sederhana dan intuitif yang mempromosikan pendekatan design-first untuk pengembangan API.

Buat Skrip Pasca-Prosesor Dalam Hitungan Detik

Dengan Apidog, Anda dapat menerapkan pasca-prosesor dengan cara apa pun yang Anda inginkan.

Anda dapat memilih dari berbagai pasca-prosesor, seperti pernyataan, khusus, dan bahkan skrip publik.

Impor API lain ke Apidog

Apidog mendukung berbagai jenis file API, termasuk OpenAPI (atau Swagger), Postman, dan Insomnia. Dengan cara ini, Anda dapat mengimpor proyek yang ada ke lingkungan pengembangan Apidog yang ramping untuk modifikasi lebih lanjut!

Pertama, buka bagian Pengaturan di proyek Anda, dan temukan tombol Import Data yang ditemukan di bawah Manajemen Data. Jika Anda tidak dapat menemukan jenis file yang ingin Anda impor, jangan khawatir! Cukup seret dan lepas file ke bagian bawah layar.

Kesimpulan

Dengan menguasai seni mengatur variabel dalam skrip pasca-permintaan Postman, Anda telah membuka alat yang ampuh untuk mengoptimalkan alur kerja pengujian API Anda. Kemampuan untuk secara dinamis menangkap dan menyimpan data dari respons memberdayakan Anda untuk membuat rangkaian pengujian yang lebih kuat, efisien, dan mudah dipelihara. Melalui pertimbangan yang cermat terhadap cakupan variabel dan teknik ekstraksi data yang efektif, Anda dapat secara signifikan meningkatkan kemampuan pengujian Anda dan mempercepat siklus pengembangan.

Ingat, kunci keberhasilan terletak pada pemahaman perilaku API Anda, merencanakan kasus pengujian Anda secara strategis, dan memanfaatkan potensi penuh fitur skrip Postman. Dengan mengikuti panduan yang disediakan dalam artikel ini, Anda akan diperlengkapi dengan baik untuk memanfaatkan kekuatan variabel dan meningkatkan pengujian API Anda ke tingkat yang lebih tinggi.