Mock Scripts

Mock scripts memungkinkan Anda membuat respons mock yang cerdas dengan hubungan logis antara parameter permintaan dan data respons. Fitur ini penting ketika Anda memerlukan data mock yang mempertahankan akurasi kontekstual atau mencerminkan nilai permintaan.

Kasus Penggunaan

Mock scripts ideal untuk skenario yang memerlukan hubungan data logis:

Contoh Umum

Mengembalikan ID pengguna dalam respons yang cocok dengan ID yang diminta (misalnya, ID permintaan 1001 → respons menyertakan ID 1001)

Memastikan konsistensi temporal (misalnya, waktu selesai selalu setelah waktu mulai)

Menghitung bidang terkait (misalnya, harga total berdasarkan jumlah dan harga satuan)

Mencerminkan parameter permintaan dalam payload respons

Cara Kerja Mock Scripts

Mock scripts memproses data melalui alur kerja lima langkah:

Smart mock atau fitur mock lainnya menghasilkan respons awal

Mock script mengakses objek $$.mockResponse dan $$.mockRequest

Logika JavaScript mengambil dan memproses data dari objek-objek ini

Metode $$.mockResponse.setBody memperbarui respons dengan data yang telah dimodifikasi

Mesin mock mengembalikan respons akhir yang telah diproses

Mock scripts hanya berfungsi dengan Smart mock. Mock scripts tidak berlaku untuk mock expectations atau contoh respons.

Menggunakan Mock Scripts

Mengaktifkan dan Menulis Skrip

Buka tab Mock tempat bagian Mock Script muncul di bagian bawah

Aktifkan sakelar skrip

Tulis skrip Anda di editor dan simpan

Referensi Skrip

Contoh Dasar

Yang dilakukan skrip ini:

Mengambil respons mock awal yang dibuat secara otomatis

Memodifikasi respons dengan:

Mengatur page agar cocok dengan parameter halaman yang diminta

Mengatur nilai total tetap sebesar 120

Memperbarui respons mock dengan perubahan ini

Objek $$.mockRequest

Objek $$.mockRequest merepresentasikan permintaan masuk. Objek ini mirip dengan objek pm.request milik Postman dengan fitur tambahan.

Metode Utama:

Metode/Properti	Deskripsi
`getParam(key)`	Mengambil parameter dari lokasi mana pun (query, body, dll.)
`headers`	Mengakses header HTTP
`cookies`	Mengakses nilai cookie
`body`	Mengakses body permintaan
`formdata`	Mengakses parameter form-data
`urlencoded`	Mengakses parameter URL-encoded

Contoh Penggunaan:

Objek $$.mockResponse

Objek $$.mockResponse merepresentasikan respons yang dikirim kembali. Objek ini mirip dengan objek pm.response milik Postman dengan metode kontrol tambahan.

Metode Utama:

Metode	Parameter	Deskripsi
`setBody(body)`	any	Mengatur body respons
`setCode(code)`	number	Mengatur kode status HTTP
`setDelay(duration)`	number (ms)	Menambahkan penundaan respons (mensimulasikan latensi)
`json()`	-	Mengambil respons sebagai JSON
`headers`	-	Mengakses/memodifikasi header respons

Contoh Penggunaan:

FAQ

Q: Bagaimana cara menggunakan variabel Apidog dalam mock scripts?

A: Mock scripts tidak dapat menggunakan variabel Apidog.

Variabel adalah fitur klien Apidog, tetapi mesin mock berjalan secara independen dan tidak dapat mengakses variabel sisi klien.

Q: Bagaimana cara menggunakan pernyataan log dalam mock scripts?

A: Mock scripts tidak menyediakan fungsionalitas logging.

Konsol adalah fitur sisi klien, tetapi mesin mock beroperasi secara terpisah dan tidak dapat mengeluarkan log ke konsol klien.

Q: Mengapa saya tidak dapat menggunakan objek pm dalam mock scripts?

A: Objek pm tidak tersedia dalam mock scripts.

Mock scripts dieksekusi di server mock, sedangkan pre/post scripts dieksekusi di klien Apidog. Ini adalah lingkungan eksekusi yang sepenuhnya berbeda dengan objek dan sintaks yang tersedia yang berbeda.

Q: Apakah mock scripts berfungsi dengan mock expectations?

A: Tidak, mock scripts hanya berfungsi dengan Smart mock.

Ketika mock expectation cocok, mock script tidak akan dieksekusi. Mock scripts tidak berlaku untuk mock expectations atau contoh respons.

Kasus Penggunaan#

Cara Kerja Mock Scripts#

Menggunakan Mock Scripts#

Mengaktifkan dan Menulis Skrip#

Referensi Skrip#

Contoh Dasar#

Objek $$.mockRequest#

Objek $$.mockResponse#

FAQ#

Kasus Penggunaan

Cara Kerja Mock Scripts

Menggunakan Mock Scripts

Mengaktifkan dan Menulis Skrip

Referensi Skrip

Contoh Dasar

Objek $$.mockRequest

Objek $$.mockResponse

FAQ