指南

渲染模式

什么时候用 none、basic 还是 full 渲染

renderMode 控制 Thunderbit 在处理之前如何抓取页面。它是延迟、成本、动态内容处理能力之间的杠杆。

none(默认)

普通 HTTP 抓取。不开浏览器,不执行 JavaScript。

  • 适用场景:服务器渲染页面、RSS、JSON 端点、传统博客
  • 延迟:最低
  • 限制:在 SPA 和需要 JS hydration 的内容上会返回空 / 壳 HTML

basic

带 JS 执行的 headless 浏览器,但不等完整 hydration。

  • 适用场景:需要 JS 渲染但能很快稳定下来的页面
  • 延迟:约为 none 的 1–2 倍
  • 限制:晚到的内容(懒加载、异步抓取)可能漏抓

full

带完整 hydration 的 headless 浏览器,可配 waitFor

  • 适用场景:SPA、无限滚动、从 API 拉数据 hydrate 的内容
  • 延迟:最高
  • 小贴士waitFor(毫秒)只在你确实需要时才搭配用 —— 多余的等待会让每个请求都付出延迟代价

怎么选

  1. 先用 none。如果拿到空内容(SCRAPE_EMPTY_CONTENT),再升级。
  2. 接着试 basic
  3. 已知是 SPA 时回落到 full

不要"以防万一"就默认用 full —— 大多数页面用不上 headless 浏览器,你会白白多付出 5–10 倍的延迟。

本页正在补充各模式的基准测试 —— 敬请期待。