Bagikan melalui

Menggunakan Dev Proxy dengan solusi SharePoint Framework (SPFx)

Sekilas
Tujuan: Menggunakan Dev Proxy dengan SharePoint Framework
Waktu: 10 menit
Plugin: Berbagai
Prasyarat:Menyiapkan Proksi Dev, lingkungan pengembangan SPFx

SharePoint Framework (SPFx) adalah model pengembangan untuk memperluas SharePoint, Microsoft Teams, Microsoft Viva, dan Microsoft 365. Saat Anda membangun solusi SPFx, Anda dapat menggunakan Dev Proxy untuk mencegat permintaan web yang dibuat oleh solusi Anda dan melihat caranya menangani kesalahan API.

Mencegat permintaan web yang dibuat oleh solusi SPFx Anda

Solusi SharePoint Framework adalah aplikasi sisi klien yang berjalan di browser web. Sebelum memulai Dev Proxy, Anda perlu mengonfigurasinya untuk mencegat permintaan yang dibuat oleh solusi SPFx Anda. Seringkali, Anda ingin mencegat permintaan ke Microsoft Graph dan REST API SharePoint. Jika Anda menggunakan API kustom, Anda juga ingin menghalangi permintaan ke API tersebut. Anda dapat menentukan URL untuk dicegat dalam properti urlsToWatch di file konfigurasi Dev Proxy.

File: devproxyrc.json (bagian urlsToWatch)

{
  // [...] trimmed for brevity
  "urlsToWatch": [
    "https://graph.microsoft.com/*",
    "https://*.sharepoint.com/*"
    // other URLs to watch
  ]
}

Tips

Saat menggunakan Dev Proxy dengan solusi SharePoint Framework, gunakan preset SPFx dari Galeri Solusi Sampel. Ini berisi konfigurasi umum untuk mencegat permintaan web yang dibuat oleh solusi SPFx, termasuk permintaan ke Microsoft Graph dan REST API SharePoint.

Saat Anda memulai Dev Proxy di komputer Anda, Ia secara otomatis mencegat permintaan web yang dibuat oleh solusi SPFx Anda dan mensimulasikan respons yang dikonfigurasi. Anda tidak perlu mengubah solusi SPFx anda untuk menggunakan Dev Proxy.

Mengonfigurasi Dev Proxy untuk tidak mencegat permintaan workbench SharePoint Framework

Saat membangun solusi SPFx, Anda menggunakan workbench SharePoint Framework untuk menguji komponen web Anda. Workbench SharePoint Framework berjalan di browser web dan menggunakan API SharePoint untuk memuat komponen web. Secara default, Dev Proxy mencegat semua permintaan web dari browser web Anda, termasuk permintaan yang dibuat oleh workbench SharePoint Framework. Akibatnya, ini dapat mencegah Anda menguji komponen web Anda.

Untuk menghindari Dev Proxy memblokir permintaan yang dibuat oleh workbench SharePoint Framework, konfigurasikan Dev Proxy untuk tidak mencegat permintaan ke API bagian web. Dalam file konfigurasi Dev Proxy Anda, kecualikan API dengan memperbarui urlsToWatch properti .

Berkas: devproxyrc.json (bagian urlsToWatch yang dikecualikan)

{
  // [...] trimmed for brevity
  "urlsToWatch": [
    "!https://*.sharepoint.com/_api/web/GetClientSideComponents*"
    // other URLs to watch
  ]
}

Tips

Jika Anda menggunakan preset SPFx dari Galeri Solusi Sampel, itu sudah mengecualikan URL ini agar tidak disadap oleh Dev Proxy.

Lihat juga

  • Last updated on