renderToNodeStream

const stream = renderToNodeStream(reactNode)

• リファレンス
  • renderToNodeStream(reactNode)
• 使用法
  • React ツリーを HTML として Node.js �? Readable ストリームにレンダーする

リファレンス

renderToNodeStream(reactNode)

サーバ上において、renderToNodeStream を呼び出して、レスポンスにパイプすることができる Node.js �? Readable ストリームを取得します。

import { renderToNodeStream } from 'react-dom/server';

const stream = renderToNodeStream(<App />);
stream.pipe(response);

クライアント側では、こ�?ようにサーバ生成された HTML を操作可能にするために hydrateRoot を用います。

さらに例を見る

引数

• reactNode: HTML にレンダーしたい React ノード。例えば、<App /> �?ような JSX 要素。

返り値

HTML 文字列を出力する Node.js �? Readable ストリーム。

注意点

• こ�?メソッドは、すべて�?サスペンスバウンダリが�?�了するまで、出力を返さず待機します。

• React 18 時点において、こ�?メソッドはすべて�?出力をバッファリングするため、�?�際にはストリームを使用する利点が得られません。これが、代わりに renderToPipeableStream に移行することが推奨される理由です。

• 返されるストリームは、utf-8 でエンコードされたバイトストリームです。別�?エンコーディング�?ストリームが必要な場合は、テキスト�?トランスコーディング用�?変換ストリームを提供する iconv-lite �?ようなプロジェクトを参照してください。

使用法

React ツリーを HTML として Node.js �? Readable ストリームにレンダーする

renderToNodeStream を呼び出して、サーバから�?レスポンスにパイプできる Node.js �? Readable ストリームを取得します。

import { renderToNodeStream } from 'react-dom/server';

// The route handler syntax depends on your backend framework
app.use('/', (request, response) => {
  const stream = renderToNodeStream(<App />);
  stream.pipe(response);
});

こ�?ストリームは、React コンポーネント�?非インタラクティブな初期 HTML 出力を生成します。クライアント側では、サーバが生成した HTML �?ハイドレーションを行い操作可能にするために、hydrateRoot を呼び出す必要があります。