HTML Streamingは何を優先したのか:送る単位を変えるという価値選択

著者: ClaudeMix Team |

React RouterのHTML Streamingは、「全データが揃うまで完全なHTMLを待つ」責務を、「描けるものから先に送る」責務へ再配置することを優先している。

① HTML Streamingは何を優先したか

一般的な renderToString によるSSRは、全ての loader がデータ取得を終えるまでHTML文字列を生成できない。3つのクエリがそれぞれ20ms・180ms・90msかかる場合、TTFBは最も遅いクエリを含む合計時間になる。ユーザーはその間、白い画面を見続ける。

defer() / Await / Suspense の組み合わせは、この前提を変える。ページのうちデータを待たなくても生成できる部分(シェル)を先に送り、データに依存する部分だけを解決次第ストリームで差し込む。

  • 【優先した価値】: 体感速度(First Contentful Paint)。ユーザーが「何かが始まった」と感じる時間を最小化する
  • 【犠牲にした価値】: 実装とデバッグの単純さ。loader を「何をawaitし、何をdeferするか」に分類する設計が必要になり、ストリームの途中でエラーが起きた場合の切り分けが従来のSSRより複雑になる

② ClaudeMixでやったこと

Before: 全ての loader はデータを await してから返す、通常のSSRパターンで実装している。

// app/routes/blog.$slug.tsx(現状)
export async function loader({ params }: LoaderFunctionArgs) {
  const postMeta = await getPostMeta(params.slug);
  const relatedPosts = await getRelatedPosts(params.slug);
  return { postMeta, relatedPosts };
}

After: defer() の導入は見送り、現状を維持することにした。判断の前提として、現在の全データソースの取得速度を確認した。

データソース 取得速度 ストリーミングの恩恵
Markdownファイル 高速(ファイルシステム) なし
YAMLスペックファイル 高速(インメモリ) なし
Cloudflare D1 通常は高速 ほぼなし

ブログ記事詳細ページの「データ」はMarkdown本文そのもので、外部APIを待つ必要がない。

③ 技術的負債

  • 【解消した負債】: なし(未導入のため発生していない)
  • 【新たに生まれた負債(あれば)】: なし。ただしAIによる思想IRテキスト生成でAnthropic APIへのリクエストが必要になったとき、複数ユーザーの判断データを集計する重い処理が生まれたときは、この判断を再評価する必要がある

現在のデータ取得は全て高速で、ストリーミング導入によるFCP改善を本文の記述から数え直せる形で示すことができない。そのため定量的な比較は行わない。

④ 経営翻訳

問い合わせ窓口が、回答に必要な情報を全て揃えてから一括で回答する体制と、分かっている部分から先に案内し残りを追って伝える体制、どちらを取るかという選択に相当する。現状は問い合わせのほとんどが即答できる範囲に収まっており、分割案内の体制を組む複雑さに見合う効果が確認できていない。

将来、回答に時間がかかる問い合わせ(外部への確認が必要な案件など)が増えたときに、分割案内の体制へ切り替える判断にした。