react-selective-hydration
React 18以降におけるストリーミングSSRと選択的ハイドレーションの組み合わせ手法を解説するスキルです。ページ全体をストリーミングしながら、インタラクティブなコンポーネントを優先してハイドレーションしたい場合に使用します。
description の原文を見る
Teaches selective hydration combined with streaming SSR in React 18+. Use when you need to prioritize hydrating interactive components while streaming the rest of the page.
SKILL.md 本文
選択的ハイドレーション
前のいくつかの記事では、SSR とハイドレーションがユーザー体験をどのように改善できるかをカバーしました。React は react-dom/server ライブラリが提供する renderToString メソッドを使用して、サーバー上でツリーを(素早く)生成し、ツリー全体が生成された後にクライアントに送信できます。レンダリングされた HTML は、JavaScript バンドルがフェッチされてロードされるまでインタラクティブではなく、その後 React はツリーを下に歩んでハイドレーションを行い、ハンドラーをアタッチします。
ただし、このアプローチは現在の実装の制限により、パフォーマンスの問題につながる可能性があります。
使用時期
- SSR ページの一部をすべての JavaScript がロードされる前にインタラクティブにしたい場合に使用
- 遅いコンポーネント(例:データ取得コンポーネント)がページ全体のハイドレーションをブロックしている場合に便利です
手順
Suspense境界を使用して、独立してハイドレーション可能な UI の塊を区切る- ストリーミング SSR に
renderToPipeableStream(Node)またはrenderToReadableStream(エッジ)を使用 - 重いデータ取得コンポーネントを
Suspenseの内部に配置して、兄弟のハイドレーションを遅延させない - クリティカルなインタラクティブコンポーネントが長時間のロード中フォールバック内にないことを確認
- 選択的ハイドレーションのメリットを得るために
hydrateRoot(React 18+)を使用
詳細
サーバーレンダリングされた HTML ツリーをクライアントに送信できるようになる前に、すべてのコンポーネントが準備完了である必要があります。つまり、外部 API 呼び出しに依存しているか、何らかの遅延を引き起こす可能性があるプロセスに依存しているコンポーネントは、小さなコンポーネントが素早くレンダリングされるのをブロックしてしまうかもしれません。
ツリー生成が遅くなる以外に、もう1つの問題は React がツリーを一度だけハイドレーションするという事実です。これは、React がコンポーネントのいずれかをハイドレーションできる前に、すべてのコンポーネントの JavaScript をフェッチしておく必要があることを意味します。つまり、小さなコンポーネント(バンドルが小さい)は、大きなコンポーネントのコードがフェッチされてロードされるまで待つ必要があり、その後初めて React はあなたのウェブサイトでコンポーネントをハイドレーションできます。この間、ウェブサイトはインタラクティブではありません。
React 18 は、ストリーミング サーバーサイドレンダリングを新しいハイドレーションアプローチと組み合わせることで、これらの問題を解決しています:選択的ハイドレーション!
renderToString の代わりに、モダンな React SSR は Node ランタイムで renderToPipeableStream()、Web Stream ランタイムで renderToReadableStream() を使用します。
これらの API は hydrateRoot() と Suspense と組み合わせることで、大きなコンポーネントが準備完了するのを待つことなく HTML のストリーミングを開始できます。これは SSR を使用する際にコンポーネントを遅延ロードでき、ページの残りの部分のハイドレーションをブロックしないことを意味します。
以前はツリー生成と TTI を遅くしていた Comments コンポーネントは、今では Suspense でラップされています。これは React に、このコンポーネントがツリーの残りの生成を遅くしないよう指示します。代わりに、React はフォールバック コンポーネントを最初レンダリングされた HTML として挿入し、クライアントに送信される前にツリーの残りの生成を続けます。
その間、Comments コンポーネントに必要な外部データをまだフェッチしています。
選択的ハイドレーションにより、Comments コンポーネントが送信される前でさえ、クライアントに送信されたコンポーネントを既にハイドレーションすることが可能になります!
Comments コンポーネントのデータが準備完了されると、React はこのコンポーネントの HTML と、フォールバック ローダーを置き換えるための小さな <script> のストリーミングを開始します。
React は新しい HTML が注入された後、ハイドレーションを開始します。
React 18 は、SSR で React を使用する際に人々が頻繁に遭遇する問題のいくつかを修正しています。
ストリーミング レンダリングにより、コンポーネントの準備ができたらすぐにストリーミングを開始でき、サーバーで生成するのに時間がかかるコンポーネントのために FCP と TTI が低下するリスクを負いません。
すべての JavaScript のロードを待ってハイドレーションを開始する必要がなくなったため、コンポーネントはクライアントにストリーミングされるとすぐにハイドレーションでき、すべてのコンポーネントがハイドレーションされる前でもアプリとインタラクトを開始できます。
ソース
参考資料
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- patternsdev
- リポジトリ
- patternsdev/skills
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/patternsdev/skills / ライセンス: MIT
関連スキル
doubt-driven-development
重要な判断はすべて、本番環境への展開前に新しい視点から対抗的レビューを実施します。速度より正確性が重要な場合、不慣れなコードを扱う場合、本番環境・セキュリティに関わるロジック・取り消し不可の操作など影響度が高い場合、または後でバグを修正するよりも今検証する方が効率的な場合に活用してください。
apprun-skills
TypeScriptを使用したAppRunアプリケーションのMVU設計に関する総合的なガイダンスが得られます。コンポーネントパターン、イベントハンドリング、状態管理(非同期ジェネレータを含む)、パラメータと保護機能を備えたルーティング・ナビゲーション、vistestを使用したテストに対応しています。AppRunコンポーネントの設計・レビュー、ルートの配線、状態フローの管理、AppRunテストの作成時に活用してください。
desloppify
コードベースのヘルスチェックと技術負債の追跡ツールです。コード品質、技術負債、デッドコード、大規模ファイル、ゴッドクラス、重複関数、コードスメル、命名規則の問題、インポートサイクル、結合度の問題についてユーザーが質問した場合に使用してください。また、ヘルススコアの確認、次の改善項目の提案、クリーンアップ計画の作成をリクエストされた際にも対応します。29言語に対応しています。
debugging-and-error-recovery
テストが失敗したり、ビルドが壊れたり、動作が期待と異なったり、予期しないエラーが発生したりした場合に、体系的な根本原因デバッグをガイドします。推測ではなく、根本原因を見つけて修正するための体系的なアプローチが必要な場合に使用してください。
test-driven-development
テスト駆動開発により実装を進めます。ロジックの実装、バグの修正、動作の変更など、あらゆる場面で活用できます。コードが正常に動作することを証明する必要がある場合、バグ報告を受けた場合、既存機能を修正する予定がある場合に使用してください。
incremental-implementation
変更を段階的に実施します。複数のファイルに影響する機能や変更を実装する場合に使用してください。大量のコードを一度に書こうとしている場合や、タスクが一度では完結できないほど大きい場合に活用します。