컨텐츠로 건너뛰기

실험적 클라이언트 사전 렌더링

타입: boolean
기본값: false

Added in: astro@4.2.0

지원되는 브라우저의 클라이언트에서 미리 가져온 페이지를 사전 렌더링할 수 있습니다.

이 기능은 실험적인 Speculation Rules Web API를 사용하며 전역적으로 기본 prefetch 동작을 향상시켜 클라이언트에서 링크를 사전 렌더링합니다. 이 기능을 활성화하기 전에 클라이언트에서 사전 렌더링할 때의 잠재적 위험을 검토하는 것이 좋습니다.

astro.config.mjs에서 원하는 prefetch 구성 옵션과 함께 클라이언트 측 사전 렌더링을 활성화하세요:

astro.config.mjs
{
prefetch: {
prefetchAll: true,
defaultStrategy: 'viewport',
},
experimental: {
clientPrerender: true,
},
}

사이트의 모든 <a /> 링크에서 data-astro-prefetch 속성을 계속 사용하여 프리페칭을 설정하세요. 문서의 head에 <link> 태그를 추가하거나 JavaScript로 페이지를 가져오는 대신, 해당하는 추측 규칙이 포함된 <script> 태그가 추가됩니다.

클라이언트 측 사전 렌더링에는 브라우저 지원이 필요합니다. Speculation Rules API가 지원되지 않는 경우, prefetch는 지원되는 전략으로 대체됩니다.

더 많은 prefetch 옵션과 사용법은 프리페치 가이드를 참조하세요.

기여하기 커뮤니티 Sponsor