가이드
Render Modes
none, basic, full 렌더링을 언제 사용해야 하는가
renderMode는 Thunderbit가 처리 전에 페이지를 어떻게 가져오는지 제어합니다. 지연 시간, 비용, 동적 콘텐츠 처리 능력 사이의 레버입니다.
none (기본)
평범한 HTTP fetch. 브라우저 없음, JavaScript 실행 없음.
- 사용처: 서버 렌더링 페이지, RSS, JSON 엔드포인트, 클래식 블로그
- 지연 시간: 가장 낮음
- 한계: SPA와 JS-hydrated 콘텐츠에서는 빈 / 셸 HTML을 반환
basic
JS 실행이 가능한 headless 브라우저. 단, 완전한 hydration 대기는 없음.
- 사용처: JS 렌더링이 필요하지만 빠르게 안정화되는 페이지
- 지연 시간:
none의 약 1–2배 - 한계: 늦게 도착하는 콘텐츠(lazy-loaded, async fetch)는 누락될 수 있음
full
완전한 hydration + 설정 가능한 waitFor를 갖춘 headless 브라우저.
- 사용처: SPA, 무한 스크롤, API에서 hydrate되는 콘텐츠
- 지연 시간: 가장 높음
- 팁:
waitFor(ms)는 정말 필요할 때만 함께 쓰세요 —— 추가 대기는 모든 요청에서 지연 시간 비용을 발생시킵니다
선택 방법
none으로 시작하세요. 빈 콘텐츠(SCRAPE_EMPTY_CONTENT)가 나오면 한 단계 올리세요.- 다음으로
basic을 시도하세요. - 알려진 SPA에는
full로 fallback하세요.
"혹시 모르니" full을 기본값으로 쓰지 마세요 —— 대부분의 페이지에서 이득 없이 5–10배 지연 시간을 지불하게 됩니다.
이 페이지는 모드별 벤치마크로 확장 중입니다 —— 곧 다시 확인하세요.