Vite と React.js を使用したサーバーサイド レンダリング (SSR) のガイド

サーバーサイド レンダリング (SSR) の概念と、それが Web アプリケーションのユーザー エクスペリエンスをどのように向上させるかについて詳しく見てみましょう。

サーバーサイドレンダリングの概念

ユーザーが Web サイトにアクセスすると、通常、最初は裸の HTML を受け取り、その後 JavaScript (例: App.js) や CSS (例: style.css) などの追加アセットの読み込みがトリガーされます。この従来のアプローチはクライアント側レンダリングと呼ばれることが多く、ユーザーは意味のあるコンテンツを表示する前に、これらのリソースがダウンロードされて実行されるまで待つ必要があります。この遅延は、特に低速の接続やデバイスを使用しているユーザーにとって、最適ではないユーザー エクスペリエンスをもたらす可能性があります。

サーバー側レンダリング は、最初のリクエストに応じて完全にレンダリングされた HTML ページをユーザーに送信することで、この問題に対処します。この事前レンダリングされた HTML には完全なマークアップが含まれているため、ユーザーは JavaScript のロードと実行を待たずにコンテンツをすぐに確認できます。

SSR の主な利点は次のとおりです:

• 最大コンテンツフル ペイント (LCP) までの時間の短縮: サーバーが完全な HTML ドキュメントを送信するため、ユーザーはコンテンツをより速く表示できます。

• SEO の改善: コンテンツは HTML ですぐに利用できるため、検索エンジンはコンテンツのインデックスをより効率的に作成できます。

• 初期ユーザー エクスペリエンスの向上: ユーザーはコンテンツの読み取りと操作をより早く開始できるため、エンゲージメント率が向上します。

パフォーマンス指標のバランスを取る

SSR は LCP を減らすことができますが、次のペイント (INP) へのインタラクションの時間が長くなる可能性があります。これは、ページが読み込まれた後、ユーザーがページを操作するのにかかる時間です。目標は、ユーザーがボタンをクリックするなど、サイトを操作することを決定するまでに、必要な JavaScript がバックグラウンドで読み込まれ、操作がスムーズかつシームレスになるようにすることです。

SSR の実装が不十分だと、JavaScript がまだ読み込まれていないため、ユーザーがコンテンツを表示しても操作できないというシナリオが発生する可能性があります。これは、最初にページ全体が読み込まれるのを待つよりもイライラする可能性があります。したがって、SSR がユーザー エクスペリエンスを真に向上させているかどうかを確認するには、パフォーマンス指標を継続的に監視および測定することが重要です。

Vite と React.js での SSR のセットアップ

これをいくつかのステップに分けて説明します。

1. ClientApp コンポーネントを作成する
2. index.html を更新
3. ServerApp コンポーネントを作成する
4. ビルド スクリプトをセットアップする
5. ノードサーバーを構成する

1. ClientApp コンポーネントを作成する

まず、ブラウザ固有の機能をすべて処理する ClientApp.jsx ファイルを作成します。

// ClientApp.jsx
import { hydrateRoot } from 'react-dom/client';
import { BrowserRouter } from 'react-router-dom';
import App from './App';

ここでは、水和物ルートをreact-dom/clientからインポートし、BrowserRouterをreact-router-domからインポートし、メインのAppコンポーネントをインポートします。

// ClientApp.jsx
// Hydrate the root element with our app
hydrateRoot(document.getElementById('root'), 
  <browserrouter>
    <app></app>
  </browserrouter>
);

クライアント側でアプリをレンダリングするために hybridRoot を使用し、ルート要素を指定してアプリを BrowserRouter でラップします。この設定により、ブラウザ固有のすべてのコードがここに残ることが保証されます。

次に、App.jsx を変更する必要があります。

// App.jsx
import React from 'react';

// Exporting the App component
export default function App() {
  return (
    <div>
      <h1 id="Welcome-to-My-SSR-React-App">Welcome to My SSR React App!</h1>
    </div>
  );
}

ここでは、デモンストレーションの目的で App コンポーネントを単純にしておきます。クライアント環境とサーバー環境の両方で使用できるようにエクスポートします。

2.index.htmlを更新する

次に、App.jsx の代わりに ClientApp.jsx をロードするように、index.html を更新する必要があります。また、ルート div でコンテンツをストリーミングできるように、サーバー内の HTML ファイルを分割するための解析トークンも追加する必要があります。

  
    <meta charset="UTF-8">
    <link rel="icon" type="image/svg+xml" href="./vite.svg">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Vite + React + TS</title>
  
  
    <div id="root"><!--not rendered--></div>
    <script type="module" src="./src/ClientApp.jsx"></script>
  

3. ServerApp コンポーネントを作成する

次に、サーバー側のレンダリング ロジックを処理する ServerApp.jsx ファイルを作成しましょう。

// ServerApp.jsx
import { renderToPipeableStream } from 'react-dom/server';
import { StaticRouter } from 'react-router-dom/server';
import App from './App';

// Export a function to render the app
export default function render(url, opts) {
  // Create a stream for server-side rendering
  const stream = renderToPipeableStream(
    <staticrouter location="{url}">
      <app></app>
    </staticrouter>,
    opts
  );

  return stream;
}

4. ビルド スクリプトのセットアップ

クライアント バンドルとサーバー バンドルの両方をビルドするには、package.json のビルド スクリプトを更新する必要があります。

{
  "scripts": {
    "build:client": "tsc vite build --outDir ../dist/client",
    "build:server": "tsc vite build --outDir ../dist/server --ssr ServerApp.jsx",
    "build": "npm run build:client && npm run build:server",
    "start": "node server.js"
  },
  "type": "module"
}

ここでは、クライアントとサーバーに個別のビルド スクリプトを定義します。 build:client スクリプトはクライアント バンドルを構築し、build:server スクリプトは ServerApp.jsx を使用してサーバー バンドルを構築します。ビルド スクリプトは両方のビルド ステップを実行し、起動スクリプトはserver.js (次のステップで作成されます) を使用してサーバーを実行します。

∴ TypeScript を使用していない場合は、クライアントとサーバーのビルドから tsc を削除します。

5. ノードサーバーの構成

最後に、server.js で Node サーバーを構成しましょう。

// server.js
import express from 'express';
import fs from 'fs';
import path from 'path';
import { fileURLToPath } from 'url';
import renderApp from './dist/server/ServerApp.js';

const __dirname = path.dirname(fileURLToPath(import.meta.url));
const PORT = process.env.PORT || 3001;

// Read the built HTML file
const html = fs.readFileSync(path.resolve(__dirname, './dist/client/index.html')).toString();
const [head, tail] = html.split('<!--not rendered-->');

const app = express();

// Serve static assets
app.use('/assets', express.static(path.resolve(__dirname, './dist/client/assets')));

// Handle all other routes with server-side rendering
app.use((req, res) => {
  res.write(head);

  const stream = renderApp(req.url, {
    onShellReady() {
      stream.pipe(res);
    },
    onShellError(err) {
      console.error(err);
      res.status(500).send('Internal Server Error');
    },
    onAllReady() {
      res.write(tail);
      res.end();
    },
    onError(err) {
      console.error(err);
    }
  });
});

app.listen(PORT, () => {
  console.log(`Listening on http://localhost:${PORT}`);
});

In this file, we set up an Express server to handle static assets and server-side rendering. We read the built index.html file and split it into head and tail parts. When a request is made, we immediately send the head part, then pipe the stream from renderApp to the response, and finally send the tail part once the stream is complete.

By following these steps, we enable server-side rendering in our React application, providing a faster and more responsive user experience. The client receives a fully rendered page initially, and the JavaScript loads in the background, making the app interactive.

Conclusion

By implementing server-side rendering (SSR) in our React application, we can significantly improve the initial load time and provide a better user experience. The steps involved include creating separate components for client and server rendering, updating our build scripts, and configuring an Express server to handle SSR. This setup ensures that users receive a fully rendered HTML page on the first request, while JavaScript loads in the background, making the application interactive seamlessly. This approach not only enhances the perceived performance but also provides a robust foundation for building performant and scalable React applications.

以上がVite と React.js を使用したサーバーサイド レンダリング (SSR) のガイドの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。