Aracılığıyla paylaş

SharePoint Framework (SPFx) çözümleriyle Dev Proxy kullanma

Bir bakışta
Hedef: SharePoint Framework ile Dev Proxy kullanma
Süre: 10 dakika
Eklentiler: Çeşitli
Önkoşullar:Geliştirme Proxy'si, SPFx geliştirme ortamını ayarlama

SharePoint Framework (SPFx), SharePoint, Microsoft Teams, Microsoft Viva ve Microsoft 365'i genişletmeye yönelik bir geliştirme modelidir. SPFx çözümleri oluşturduğunuzda, çözümünüz tarafından yapılan web isteklerini kesmek ve API hatalarını nasıl işlediğini görmek için Dev Proxy kullanabilirsiniz.

SPFx çözümünüz tarafından yapılan web isteklerini kesme

SharePoint Framework çözümleri, web tarayıcısında çalışan istemci tarafı uygulamalardır. Geliştirme Proxy'sini başlatmadan önce SPFx çözümünüz tarafından yapılan istekleri kesecek şekilde yapılandırmanız gerekir. Genellikle Microsoft Graph ve SharePoint REST API'lerine yönelik istekleri kesmek istersiniz. Özel API'ler kullanıyorsanız, bunlara yönelik istekleri de kesmek istersiniz. Dev Proxy yapılandırma dosyasındaki urlsToWatch özelliğinde yakalanacak URL'leri tanımlayabilirsiniz.

Dosya: devproxyrc.json (urlsToWatch bölümü)

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

İpucu

SharePoint Framework Dev Proxy çözümleriyle Geliştirme Proxy'si kullanırken, Örnek Çözüm Galerisi'nden SPFx ön ayarını kullanın. Microsoft Graph ve SharePoint REST API'lerine yönelik istekler de dahil olmak üzere SPFx çözümleri tarafından yapılan web isteklerini kesmeye yönelik ortak yapılandırmayı içerir.

Makinenizde Dev Proxy'yi başlattığınızda, SPFx çözümünüz tarafından yapılan web isteklerini otomatik olarak durdurur ve yapılandırılmış yanıtların simülasyonunu oluşturur. Dev Proxy kullanmak için SPFx çözümünüzü değiştirmeniz gerekmez.

Geliştirme Proxy'sini SharePoint Framework workbench isteklerini kesmeyecek şekilde yapılandırma

SPFx çözümleri oluştururken, web bölümlerinizi test etmek için SharePoint Framework workbench'i kullanırsınız. SharePoint Framework workbench web tarayıcısında çalışır ve web bölümlerini yüklemek için SharePoint API'lerini kullanır. Varsayılan olarak Dev Proxy, SharePoint Framework workbench tarafından yapılan istekler de dahil olmak üzere web tarayıcınızdan gelen tüm web isteklerini durdurur. Sonuç olarak, web bölümlerinizi test etmenizi engelleyebilir.

Dev Proxy'nin SharePoint Framework workbench tarafından yapılan istekleri engellemesini önlemek için, Web bölümü API'sine yönelik istekleri kesmemek için Dev Proxy'yi yapılandırın. Dev Proxy yapılandırma dosyanızda urlsToWatch özelliğini güncelleyerek API'yi hariç tutun.

Dosya: devproxyrc.json (urlsToWatch bölümünün hariç tutulmasıyla)

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

İpucu

Örnek Çözüm Galerisi'nden SPFx ön ayarını kullanırsanız, bu URL'nin Geliştirme Proxy'si tarafından kesilmesini zaten dışlar.

Ayrıca bakınız

  • Last updated on