staleTimes (experimental)

경고: staleTimes 설정은 실험적 기능입니다. 이 설정 전략은 미래에 변경될 수 있습니다.

staleTimes는 클라이언트 측 라우터 캐시에서 페이지 세그먼트를 캐시할 수 있게 해주는 실험적 기능입니다.

이 실험적 기능을 활성화하고 사용자 정의 재검증 시간을 제공하려면 실험적 staleTimes 플래그를 설정하세요:

/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    staleTimes: {
      dynamic: 30,
      static: 180,
    },
  },
}
 
module.exports = nextConfig

static 및 dynamic 속성은 다른 유형의 링크 프리페칭에 따라 설정된 시간(초)을 나타냅니다.

• dynamic 속성은 Link의 prefetch 속성이 지정되지 않았거나 false로 설정된 경우에 사용됩니다.
  • 기본값: 0초 (캐시되지 않음)
• static 속성은 Link의 prefetch 속성이 true로 설정되었거나 router.prefetch를 호출할 때 사용됩니다.
  • 기본값: 5분

알아두면 좋은 점:

• 로딩 경계는 이 구성에서 정의된 static 기간 동안 재사용 가능한 것으로 간주됩니다.
• 이것은 부분 렌더링에 영향을 미치지 않으며, 공유 레이아웃이 모든 탐색에서 자동으로 다시 가져오지 않고, 변경되는 페이지 세그먼트만 다시 가져옵니다.
• 이는 뒤로/앞으로 캐싱 동작을 변경하지 않으며, 레이아웃 이동을 방지하고 브라우저 스크롤 위치를 유지하기 위해 사용됩니다.
• 이 설정의 다른 속성은 다양한 수준의 "라이브니스"를 나타내며, 세그먼트 자체가 정적 또는 동적 렌더링을 선택하는지 여부와는 관련이 없습니다. 즉, 현재 5분의 static 기본값은 데이터가 자주 재검증되지 않음으로써 정적으로 느껴지게 합니다.

클라이언트 라우터 캐시에 대해 자세히 알아보려면 여기에서 확인하세요.

Version History