Udostępnij za pośrednictwem

Korzystanie z serwera proxy deweloperskiego z rozwiązaniami programu SharePoint Framework (SPFx)

  • Artykuł

SharePoint Framework (SPFx) to model programowania umożliwiający rozszerzanie programów SharePoint, Microsoft Teams, Microsoft Viva i Microsoft 365. Podczas tworzenia rozwiązań SPFx można użyć dev proxy do przechwytywania żądań sieciowych wysyłanych przez rozwiązanie i zobaczyć, jak obsługuje błędy interfejsu API.

Przechwytywanie żądań internetowych wysyłanych przez rozwiązanie SPFx

Rozwiązania programu SharePoint Framework to aplikacje po stronie klienta, które działają w przeglądarce internetowej. Przed uruchomieniem Dev Proxy musisz go skonfigurować do przechwytywania żądań wysyłanych przez aplikację SPFx. Często chcesz przechwycić żądania do interfejsów API REST programu Microsoft Graph i programu SharePoint. Jeśli używasz niestandardowych interfejsów API, chcesz także przechwytywać żądania. Możesz zdefiniować adresy URL do przechwycenia we właściwości urlsToWatch w pliku konfiguracji Dev Proxy.

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

Napiwek

W przypadku korzystania z serwera Dev Proxy dla rozwiązań SharePoint Framework, użyj ustawienia wstępnego SPFx z Galerii Rozwiązań Przykładowych. Zawiera on wspólną konfigurację przechwytywania żądań internetowych wysyłanych przez rozwiązania SPFx, w tym żądań do programu Microsoft Graph i interfejsów API REST programu SharePoint.

Po uruchomieniu serwera proxy deweloperskiego na maszynie automatycznie przechwytuje żądania internetowe wysyłane przez rozwiązanie SPFx i symuluje skonfigurowane odpowiedzi. Nie musisz zmieniać rozwiązania SPFx, aby używać serwera proxy deweloperskiego.

Konfigurowanie serwera proxy deweloperskiego, aby nie przechwytywać żądań aplikacji Workbench programu SharePoint Framework

Podczas tworzenia rozwiązań SPFx używasz aplikacji Workbench programu SharePoint Framework do testowania składników części sieci Web. Aplikacja Workbench programu SharePoint Framework działa w przeglądarce internetowej i używa interfejsów API programu SharePoint do ładowania składników Web Part. Domyślnie, Dev Proxy przechwytuje wszystkie żądania internetowe z przeglądarki internetowej, w tym żądania wysyłane przez warsztat SharePoint Framework. W rezultacie może to uniemożliwić testowanie części witryny.

Aby uniknąć blokowania żądań wysyłanych przez warsztat SharePoint Framework, skonfiguruj serwer proxy dewelopera, aby nie przechwytywać żądań do interfejsu API składników Web Part. W pliku konfiguracji Dev Proxy wyklucz interfejs API, aktualizując właściwość urlsToWatch.

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

Wskazówka

Jeśli używasz ustawień wstępnych SPFx zaczerpniętych z Galerii Przykładowych Rozwiązań, konfiguracja ta już wyklucza przechwytywanie tego URL-u przez Dev Proxy.