SPFx(SharePoint 프레임워크) 솔루션에서 개발 프록시 사용

spFx(SharePoint 프레임워크)는 SharePoint, Microsoft Teams, Microsoft Viva 및 Microsoft 365를 확장하기 위한 개발 모델입니다. SPFx 솔루션을 빌드할 때 개발자 프록시를 사용하여 솔루션에서 수행한 웹 요청을 가로채 API 오류를 처리하는 방법을 확인할 수 있습니다.

SPFx 솔루션에서 수행한 웹 요청 가로채기

SharePoint 프레임워크 솔루션은 웹 브라우저에서 실행되는 클라이언트 쪽 애플리케이션입니다. 개발 프록시를 시작하기 전에 SPFx 솔루션에서 수행한 요청을 가로채도록 구성해야 합니다. 종종 Microsoft Graph 및 SharePoint REST API에 대한 요청을 가로채려고 합니다. 사용자 지정 API를 사용하는 경우 요청도 가로채려고 합니다. 개발자 프록시 구성 파일의 속성에서 urlsToWatch 가로챌 URL을 정의할 수 있습니다.

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

머신에서 개발 프록시를 시작하면 SPFx 솔루션에서 수행한 웹 요청을 자동으로 가로채 구성된 응답을 시뮬레이션합니다. 개발 프록시를 사용하도록 SPFx 솔루션을 변경할 필요가 없습니다.

SharePoint 프레임워크 워크벤치 요청을 가로채지 않도록 개발 프록시 구성

SPFx 솔루션을 빌드할 때 SharePoint 프레임워크 워크벤치를 사용하여 웹 파트를 테스트합니다. SharePoint 프레임워크 워크벤치는 웹 브라우저에서 실행되며 SharePoint API를 사용하여 웹 파트를 로드합니다. 기본적으로 개발자 프록시는 SharePoint 프레임워크 워크벤치의 요청을 포함하여 웹 브라우저의 모든 웹 요청을 가로채고 있습니다. 결과적으로 웹 파트를 테스트하지 못할 수 있습니다.

개발자 프록시가 SharePoint 프레임워크 워크벤치에서 수행한 요청을 차단하지 않으려면 웹 파트 API에 대한 요청을 가로채지 않도록 개발 프록시를 구성합니다. 개발자 프록시 구성 파일에서 속성을 업데이트하여 API를 제외합니다 urlsToWatch .

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