Mensimulasikan kesalahan acak untuk aplikasi Anda sendiri

Dalam tutorial ini, Anda mempelajari cara menggunakan Dev Proxy untuk mensimulasikan kesalahan acak untuk aplikasi Anda sendiri.

Prasyarat

Bagian tutorial ini mengasumsikan bahwa Anda menginstal dan mengonfigurasi Dev Proxy di komputer Anda. Jika tidak, lakukan itu sekarang.

Untuk mengikuti tutorial ini, Anda memerlukan aplikasi yang memanggil API. Anda juga perlu mengetahui URL API yang dipanggil aplikasi Anda.

Anda dapat menggunakan Dev Proxy dengan semua jenis aplikasi dan tumpukan teknologi. Berikut adalah instruksi tentang cara menyiapkan Dev Proxy dengan beberapa teknologi populer.

Gunakan Dev Proxy dengan:

• Node.js aplikasi
• Node.js aplikasi di Docker
• JavaScript Azure Functions
• solusi SharePoint Framework (SPFx)

.NET

Gunakan Dev Proxy dengan:

• aplikasi .NET
• aplikasi .NET di Docker
• aplikasi Aspire .NET

Jika Anda menggunakan Dev Proxy dengan aplikasi .NET 4.8, Anda perlu mendaftarkan Dev Proxy pada sistem Anda menggunakan netsh.

Jika Anda ingin menggunakan Dev Proxy dengan aplikasi sisi klien, biasanya Anda tidak perlu mengambil langkah tambahan apa pun. Setelah Anda memulai Dev Proxy, ia secara otomatis mencegat semua permintaan dari komputer Anda.

Jika Anda ingin menggunakan Dev Proxy dengan aplikasi sisi server yang dibangun dengan teknologi yang tidak tercantum di sini, Anda mungkin perlu mengambil langkah tambahan untuk mengonfigurasi aplikasi Anda untuk menggunakan Dev Proxy. Periksa dokumentasi teknologi Anda untuk mempelajari cara mengonfigurasinya untuk menggunakan proksi jaringan. Jika Anda memiliki pertanyaan, minta bantuan di komunitas Dev Proxy di Discord.

Mulai Dev Proxy sambil memantau URL Anda

Mulai Proksi Dev dan pantau URL API yang dipanggil aplikasi Anda. Misalnya, jika aplikasi Anda memanggil API yang terletak di https://api.contoso.com/v1/customers, mulai Proksi Dev dan pantau pola URL https://api.contoso.com/*.

devproxy --urls-to-watch "https://api.contoso.com/*"

Parameter --urls-to-watch memberi tahu Dev Proxy, permintaan mana yang akan disadap. Wildcard * di akhir URL memberi tahu Dev Proxy untuk mencegat semua permintaan ke URL yang dimulai dengan https://api.contoso.com/.

Mulai gunakan aplikasi Anda seperti biasa. Dev Proxy mencegat semua permintaan ke URL yang Anda tentukan. Di command prompt, Anda melihat pesan tentang permintaan yang disadap oleh Dev Proxy.

```text
 request     GET https://api.contoso.com/v1/customers
     api   ╭ Passed through
           ╰ GET https://api.contoso.com/v1/customers
 request     GET https://api.contoso.com/v1/customers
   chaos   ╭ 403 Forbidden
           ╰ GET https://api.contoso.com/v1/customers

Penting

Jika Anda tidak melihat pesan apa pun di prompt perintah, pastikan Anda mengonfigurasi aplikasi dengan benar untuk menggunakan Dev Proxy. Selain itu, periksa apakah Dev Proxy mencegat permintaan ke URL API yang digunakan aplikasi Anda. Jika Anda memiliki pertanyaan, minta bantuan di komunitas Dev Proxy di Discord.

Membuat file konfigurasi Anda sendiri

Secara default, Dev Proxy menggunakan file devproxyrc.json di folder penginstalan Dev Proxy untuk pengaturan konfigurasinya. File dikonfigurasi untuk mensimulasikan kesalahan acak untuk JSON Placeholder API. Untuk mendapatkan hasil yang lebih realistis, buatlah file konfigurasi Anda sendiri dengan kesalahan yang lebih relevan untuk aplikasi dan API yang Anda gunakan, lalu gunakanlah dengan Dev Proxy.

Mari kita pertimbangkan bahwa Anda ingin menyimpan file konfigurasi di folder proyek untuk aplikasi Anda, sehingga Anda dapat berbagi pengaturan konfigurasi dengan tim Anda lainnya.

1. Di folder penginstalan Dev Proxy, salin devproxyrc.json dan devproxy-errors.json.
2. Di folder proyek Anda, tempelkan file.

Saat menggunakan file konfigurasi yang disimpan di luar file penginstalan Dev Proxy, Anda perlu memastikan bahwa referensi pluginPath sudah benar. Daripada pengkodean keras jalur ke folder penginstalan Dev Proxy dalam file konfigurasi Anda, Anda dapat menggunakan ~appFolder di awal jalur untuk menyertakan referensi dinamis kembali ke folder penginstalan Proksi Dev.

1. Di editor teks, buka file devproxyrc.json.
2. Temukan plugin GenericRandomErrorPlugin di array plugins.
3. Perbarui pluginPath ke ~appFolder/plugins/DevProxy.Plugins.dll.
4. Temukan plugin RetryAfterPlugin di array plugins.
5. Perbarui pluginPath ke ~appFolder/plugins/DevProxy.Plugins.dll.
6. Pada prompt perintah, ganti direktori kerja ke folder proyek Anda.
7. Masukkan devproxy --config-file devproxyrc.json dan tekan Enter untuk memulai Dev Proxy menggunakan file konfigurasi Anda.
8. Kirim permintaan ke JSON Placeholder API dari baris perintah dan lihat output.
9. Tekan Ctrl + C untuk menghentikan Dev Proxy dengan aman.

Saran

Instal ekstensi Dev Proxy Toolkit untuk Visual Studio Code yang memudahkan untuk membuat dan memperbarui file konfigurasi.

Langkah berikutnya

Dev Proxy mendukung berbagai skenario yang membantu Anda membangun aplikasi yang lebih kuat. Jelajahi panduan cara penggunaan untuk mempelajari cara menggunakan berbagai fitur Dev Proxy dan meningkatkan aplikasi Anda.

Menjelajahi panduan cara-cara