Použití vývojového proxy serveru s řešeními SharePoint Framework (SPFx)

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í vývojového proxy serveru zachytávat webové požadavky vytvořené vaším řešením a zjistit, jak zpracovává chyby rozhraní API.

Zachytávání webových požadavků provedených řešením SPFx

SharePoint Framework řešení jsou aplikace na straně klienta, které běží ve webovém prohlížeči. Než začnete s dev proxy serverem, musíte ho nakonfigurovat tak, aby zachytávalo požadavky vašeho řešení SPFx. Často chcete zachycovat požadavky na rozhraní REST API Microsoft Graphu a SharePointu. Pokud používáte vlastní rozhraní API, chcete také zachytávat požadavky na ně. Adresy URL, které se mají zachytit, můžete definovat ve urlsToWatch vlastnosti v konfiguračním souboru vývojového proxy serveru.

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

Když na počítači spustíte dev proxy server, automaticky zachytává webové požadavky provedené vaším řešením SPFx a simuluje nakonfigurované odpovědi. Řešení SPFx nemusíte měnit, aby používalo dev proxy server.

Konfigurace vývojového proxy serveru tak, aby nezachytávala požadavky SharePoint Framework workbench

Při sestavování řešení SPFx používáte k testování webových částí SharePoint Framework Workbench. SharePoint Framework workbench běží ve webovém prohlížeči a k načítání webových částí používá rozhraní API SharePointu. Ve výchozím nastavení dev proxy zachytává všechny webové požadavky z webového prohlížeče, včetně požadavků provedených SharePoint Framework workbenchem. V důsledku toho vám může zabránit v testování webových částí.

Abyste zabránili blokování požadavků SharePoint Framework aplikací Workbench, nakonfigurujte proxy pro vývoj tak, aby nezachycoval požadavky na rozhraní API webové části. V konfiguračním souboru dev proxy vyloučíte rozhraní API aktualizací urlsToWatch vlastnosti.

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