Bagikan melalui

Mengonfigurasi Proksi Pengembang

  • Artikel

Dev Proxy sangat dapat dikonfigurasi. Ini menggunakan plugin untuk mengimplementasikan fungsionalitas. Anda dapat menggabungkan salah satu plugin standar dan membangunAnda sendiri. Dengan menggunakan plugin dan konfigurasi kustom, Anda dapat menyesuaikan Dev Proxy dengan kebutuhan spesifik Anda. Proksi Dev menyertakan file konfigurasi default, bernama devproxyrc.json. File ini terletak di folder penginstalan Dev Proxy.

Tips

Kami menyarankan agar Anda membuat file konfigurasi kustom. Dengan menggunakan file konfigurasi kustom, Anda dapat dengan mudah beralih di antara konfigurasi yang berbeda dan dapat menyertakannya dalam sistem kontrol sumber Anda bersama dengan kode proyek Anda. Menyimpan konfigurasi Anda dengan proyek Anda juga memudahkan untuk membagikannya dengan tim Anda.

Jika Anda memberi nama file konfigurasi Anda devproxyrc.json atau devproxyrc.jsonc, Dev Proxy secara otomatis memuatnya dari direktori saat ini saat Anda memulainya. Untuk nama lain, tentukan jalur file dalam argumen --config-file saat memulai Dev Proxy, misalnya devproxy --config-file ./my-devproxy-config.json.

Struktur file konfigurasi

Cuplikan kode berikut menunjukkan file konfigurasi bawaan untuk Dev Proxy (Proksi Pengembang).

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v0.24.0/rc.schema.json",
  "plugins": [
    {
      "name": "RetryAfterPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll"
    },
    {
      "name": "GenericRandomErrorPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll",
      "configSection": "genericRandomErrorPlugin"
    }
  ],
  "urlsToWatch": [
    "https://jsonplaceholder.typicode.com/*"
  ],
  "genericRandomErrorPlugin": {
    "errorsFile": "devproxy-errors.json"
  },
  "rate": 50,
  "logLevel": "information",
  "newVersionNotification": "stable",
  "showSkipMessages": true,
  "showTimestamps": true
}

File konfigurasi terdiri dari tiga bagian:

  • Skema, ditentukan dalam properti $schema. Untuk memastikan bahwa file konfigurasi Anda valid, pastikan untuk menggunakan versi skema yang sama dengan versi Proksi Dev yang Anda gunakan.
  • Daftar plugin yang digunakan Dev Proxy, didefinisikan dalam array plugins.
  • Pengaturan konfigurasi umum.

Penting

Dev Proxy menerapkan plugin dalam urutan yang tercantum dalam file konfigurasi. Perhatikan urutan untuk mendapatkan perilaku yang diinginkan.

Beberapa plugin dapat dikonfigurasi dan mengekspos pengaturan mereka sendiri. Setiap plugin memiliki bagian konfigurasinya sendiri dalam file konfigurasi, yang dirujuk oleh properti configSection dalam definisi plugin. Lihat dokumentasi referensi untuk setiap plugin untuk mempelajari selengkapnya tentang opsi konfigurasinya.

Tips

Nilai properti configSection dapat berupa string apa pun. Dengan menggunakan nama yang berbeda, Anda dapat menyertakan beberapa instans plugin yang sama, masing-masing dengan konfigurasi yang berbeda. Anda mungkin perlu mereferensikan plugin yang sama beberapa kali, misalnya, saat meniru beberapa API dengan respons dan perilaku kesalahan yang berbeda.

Dev Toolkit Proksi

Dev Proxy Toolkit adalah ekstensi Visual Studio Code yang secara signifikan menyederhanakan konfigurasi Dev Proxy. Berikut adalah beberapa fitur yang mencakup:

  • cuplikan kode untuk skenario konfigurasi umum
  • linting dan IntelliSense yang diperluas untuk file konfigurasi Dev Proxy
  • tindakan dan perintah editor kustom agar mudah memulai dan menghentikan Dev Proxy
  • pemberitahuan tentang versi baru Dev Proxy

Tips

Jika Anda menggunakan Visual Studio Code, kami sangat menyarankan Anda menginstal ekstensi Dev Proxy Toolkit.

Langkah berikutnya

Jika Anda ingin terus belajar tentang menggunakan Dev Proxy, pertimbangkan tutorial berikut:

Jika tidak, lihat panduan kami tentang cara menggunakan Dev Proxy untuk skenario tertentu.