Použití dev proxy serveru s řešeními SPFx (SharePoint Framework)

SharePoint Framework (SPFx) je vývojový model pro rozšíření SharePointu, Microsoft Teams, Microsoft Viva a Microsoftu 365. Při sestavování řešení SPFx můžete pomocí dev Proxy zachytit webové požadavky provedené vaším řešením a podívat se, jak zpracovává chyby rozhraní API.

Zachyťte webové požadavky provedené vaším řešením SPFx

Řešení služby SharePoint Framework jsou aplikace na straně klienta, které běží ve webovém prohlížeči. Než spustíte Dev Proxy, musíte ho nakonfigurovat tak, aby zachycoval požadavky odesílané vaším řešením SPFx. Často chcete zachycovat požadavky na rozhraní API Microsoft Graph a SharePoint REST. Pokud používáte vlastní rozhraní API, chcete také zachycovat požadavky na ně. Můžete definovat adresy URL, které se mají zachytit ve vlastnosti urlsToWatch v konfiguračním souboru Dev Proxy.

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

Tip

Při použití Dev Proxy s řešeními SharePoint Framework Dev Proxy použijte předvolbu SPFx z galerie ukázkových řešení. Obsahuje společnou konfiguraci pro zachycování webových požadavků prováděné řešeními SPFx, včetně požadavků na rozhraní Microsoft Graph a rozhraní REST API SharePoint.

Když na svém počítači spustíte Dev Proxy, automaticky zachytí webové požadavky provedené řešením SPFx a simuluje nakonfigurované odpovědi. Abyste mohli používat Dev Proxy, nemusíte měnit řešení SPFx.

Konfigurace vývojového proxy serveru pro nezachycování požadavků aplikace SharePoint Framework Workbench

Při vytváření řešení SPFx použijete aplikaci SharePoint Framework workbench k otestování webových částí. Aplikace SharePoint Framework workbench běží ve webovém prohlížeči a k načtení webových částí používá rozhraní API služby SharePoint. Dev Proxy ve výchozím nastavení zachytí všechny webové požadavky z webového prohlížeče, včetně požadavků provedených aplikací SharePoint Framework Workbench. V důsledku toho vám může zabránit v testování webových částí.

Aby Dev Proxy server neblokoval požadavky provedené pracovním stolem SharePoint Framework, nakonfigurujte Dev Proxy tak, aby nezachycoval požadavky na API webové části. V konfiguračním souboru Dev Proxy vyloučíte rozhraní API aktualizací parametru urlsToWatch.

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

Tip

Pokud použijete předvolbu SPFx z galerie ukázkových řešení, už tuto adresu URL vyloučí z zachycení dev proxy serverem.