webpack-dev-server を使った React + TypeScript の環境構築

本記事の対象

以下のいずれかに該当する方に役立つかと思います。

• React + TypeScript の開発環境が必要
• webpack-dev-server v3 -> v4 に移行を考えている
• create-react-app で作ったアプリを webpack-dev-server で動かしたい
• React でホットリロード機能を使用したい

はじめに

この記事では、導入することで格段に開発効率を上げることができる webpack-dev-server を使った React + TypeScript の開発環境の構築方法をご紹介します。

初めての React 環境構築なので、よりよい方法やバグ等ございましたら、アドバイスいただけると光栄です。

投稿時時点(2022/06/20)のバージョンは以下のようになっております。

$ node -v
v18.3.1

$ yarn -v
1.22.19

$ yarn list --depth=0 | grep webpack
├─ @pmmmwh/react-refresh-webpack-plugin@0.5.7
├─ @svgr/webpack@5.5.0
├─ @webpack-cli/configtest@1.2.0
├─ @webpack-cli/info@1.5.0
├─ @webpack-cli/serve@1.7.0
├─ case-sensitive-paths-webpack-plugin@2.4.0
├─ css-minimizer-webpack-plugin@3.4.1
├─ eslint-webpack-plugin@3.1.1
├─ fork-ts-checker-webpack-plugin@6.5.2
├─ html-webpack-plugin@5.5.0
├─ terser-webpack-plugin@5.3.3
├─ webpack-cli@4.10.0
├─ webpack-dev-middleware@5.3.3
├─ webpack-dev-server@4.9.2
├─ webpack-manifest-plugin@4.1.1
├─ webpack-merge@5.8.0
├─ webpack-sources@1.4.3
├─ webpack@5.73.0
├─ workbox-webpack-plugin@6.5.3

まずは、環境構築始める前にwebpack-dev-server について理解を深めていきたいと思います。

【webpack-dev-server とは?】

webpack-dev-server は、webpack を用いた開発用のサーバーで Web サーバーの自動更新を行うライブリローディング(Live Reloading)機能をを提供します。

ソースコードを変更して保存すると、差分を検知してコンパイルされ、Web サーバーが自動的にリロードされます。変更と同時に自動的に差分ビルドを行うことで更新作業を気にせず、開発に集中することができます。変更のたびに毎回、手動でビルドをしなくて済むのでとてもスムーズに開発することができます。

それでは、実際に webpack-dev-server を使った React+ TypeScript の環境構築を行っていきます。

1. React + TypeScript のプロジェクト作成

プロジェクトのひな形を create-react-app を使用して作成します。

create-react-app は、Facebook 社製の React プロジェクト作成を自動化するコマンドラインツールです。v2.1.0 で TypeScript をサポートするようになりました。以下の例では、react-server というプロジェクト名で作成しています。

• インストール方法

  $ yarn global add create-react-app
  

• 使用方法

  $ yarn create react-app react-server --template typescript
  

2. eslint, prettier の設定

React および TypeScript のスタイルガイドに準拠させ、一貫した自動フォーマットを行うために ESLint, Prettier に関する設定を行います。

ESLint と Prettier

ESLint, Prettier はそれぞれ、JavaScript のリンター, フォーマッターのディファクトスタンダードです。

ESLint は、コードを静的解析をし、バグやスタイルガイドに準拠していない部分を検知するのに役立ちます。一方、Prettier は、コードスタイルを統一することを目的としています。コードスタイルを統一することでコードスタイルの違いによる議論を避けることができるため、非常に重要なツールとなってきます。

この 2 つのツールの概要を理解したところで、 VSCode と組み合わせて設定を行っていきます。

[VSCode 拡張機能のインストール]

以下の 2 つの拡張機能をインストールします。

• ESLint

• Prettier - Code formatter

[VSCode の設定]

VSCode で Prettier を使用できるよう設定します。
以下の２つを VSCode の設定画面を開いて変更します。

• 保存時にフォーマッターが実行されるようにする
  Format On Saveにチェックを入れます。
  

• Prettier をデフォルトのフォーマッターとして使用する
  Default Formatterのセレクターから Prettier を選択します。
  

[ESLint の設定]

eslint の設定は、次のコマンドを実行して対話形式で行います。

$ yarn create @eslint/config

以下のように質問に答えていきます。

1. コードをチェックする範囲
   シンタックスおよび問題をチェックし、スタイルの適用を支援するTo check syntax, find problems, and enforce code styleを選択します。
   

2. モジュール
   ウェブブラウザがデフォルトで採用している ES Modules を選択します。
   

3. UI フレームワーク
   React を選択します。
   

4. TypeScript を使用するかどうか
   Yes を選択します。
   

5. コードの実行環境
   プロジェクトがブラウザで実行されている場合（React, Angular, Vue, etc...）、は Browser, プロジェクトが Node ベースの場合は、Node を選択します。
   今回は、Browser のみを選択します。なお、この質問に対してはスペースで複数選択することが可能です。
   

6. スタイルガイドの設定方法
   有名なスタイルガイドを使用するため、Use a popular style guideを選択します。
   

7. スタイルガイドの種類
   GitHub 上で最も人気のある Airbnb を使用します。Airbnb: https://github.com/airbnb/javascriptを選択します。
   

8. ESLint の設定ファイルの形式
   自分のお気に入りのファイル拡張子を選択します。ここでは、デフォルトの JavaScript 選択します。
   

9. 追加で必要な依存関係をインストールするか
   Yes を選択します。
   

10. 9 のインストールで使用するパッケージマネージャ
    プロジェクトで使用しているyarn を選択します。
    

すべての質問に答えると ESLint の設定ファイルである.eslintrc.jsがプロジェクト直下に作成されます。

次に ESLint と Prettier の連携を行います。プラグインとして Prettier を使用するためには ESLint に指示する必要があります。.eslintrc.js のpluginsに "prettier" を追加します。

.eslintrc.js

module.exports = {
  env: {
    browser: true,
    es2021: true,
  },
  extends: ["plugin:react/recommended", "airbnb"],
  parser: "@typescript-eslint/parser",
  parserOptions: {
    ecmaFeatures: {
      jsx: true,
    },
    ecmaVersion: "latest",
    sourceType: "module",
  },
  plugins: ["react", "@typescript-eslint", "prettier"],
  rules: {},
};

[Prettier の設定]

プロジェクト直下に Prettier の設定ファイル .prettierrc.jsonを作成します。
デフォルト設定を使用します。お気に入りの設定がある場合は、変更できます。

$ echo {} > .prettierrc.json

[ESLint, Prettier の競合阻止]

ESLint, Prettier を同時に動作させている場合、一部のルールが競合する可能性があります。この問題を回避するには、不要なルールや Prettier と競合する可能性のあるすべてのルールをオフにする必要があります。

eslint-config-prettier をインストールすることで、この問題を解決することができます。

$ yarn add -D eslint-config-prettier

これで、プロジェクトで ESLint と Prettier が完全に同時に機能するようになりました。

3. webpack-dev-server の設定

webpack を CLI から呼び出すことができる webpack-cli、TypeScript を JavaScript にトランスパイル可能な webpack 用の ローダーであるts-loaderをそれぞれインストールします。

$ yarn add -D webpack-cli ts-loader

次に、webpack の設定ファイルである webpack.config.js をプロジェクト直下に作成し、編集します。

$ touch webpack.config.js

webpack.config.js

/* eslint-disable @typescript-eslint/no-var-requires */
const path = require("path");
const HtmlWebpackPlugin = require("html-webpack-plugin");
const { WebpackManifestPlugin } = require("webpack-manifest-plugin");

module.exports = {
  mode: "development",
  devtool: "inline-source-map",
  entry: "./src/index.tsx",
  devServer: {
    open: true,
    hot: true,
    host: "0.0.0.0",
    port: 3000,
  },
  module: {
    rules: [
      {
        test: /\.tsx?$/,
        use: "ts-loader",
        exclude: /node_modules/,
      },
      {
        test: /\.css$/i,
        use: ["style-loader", "css-loader"],
        exclude: /node_modules/,
      },
      {
        test: /\.(jpe?g|png|gif|svg|ico)$/i,
        loader: "file-loader",
        options: {
          name: "[name].[ext]",
        },
        exclude: /node_modules/,
      },
    ],
  },
  resolve: {
    extensions: [".tsx", ".ts", ".js"],
  },
  output: {
    path: path.resolve(__dirname, "build"),
    filename: "bundle.js",
  },
  plugins: [
    new HtmlWebpackPlugin({
      template: "public/index.html",
      favicon: "public/favicon.ico",
    }),
    new WebpackManifestPlugin(),
  ],
};

オプション名	説明
mode	webpack の開発モード。production(製品), development(開発), none(デフォルト)の 3 つのモードに応じて読み込む webpack.config.js 分けることができます。
devtool	ソースマップを生成とその方法。このオプションを指定することでソースマップが生成されるようになります。
entry	アプリケーションのバンドルを開始するエントリー。主にメインスレッドとなるファイルを指定します。
module.rules	モジュールの作成時のルール。モジュールにローダーを適用したり、パーサーを変更したりできます。
resolve.extensions	モジュールの拡張子の解決。配列の最初から順番にリストされている拡張子を持つファイルを解決し、残りをスキップします。
devServer	webpack-dev-server の設定。開発用 Web サーバーの様々な設定を行うことができます。
plugins	webpack のビルドプロセスをカスタマイズするためのプラグイン。

ローダーとして指定した ts-loader ですがnoEmit オプションが有効になっているとでエラーが出るので無効にします。

tsconfig.json の compilerOptions.noEmit を true から false に変更します。

tsconfig.json

{
  "compilerOptions": {
    "noEmit": "false"
     ︙
  }
}

4. index.html の編集

publicディレクトリのindex.htmlを編集します。

静的ファイルのある「public」ディレクトリに合わせてファイルパスを変更します。webpack.config.js のdevServer.static オプションはデフォルトで静的ファイルのディレクトリとして「public」ディレクトリを提供します。

public / index.html

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <link rel="icon" href="favicon.ico" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <meta name="theme-color" content="#000000" />
    <meta
      name="description"
      content="Web site created using create-react-app"
    />
    <link rel="apple-touch-icon" href="logo192.png" />
    <link rel="manifest" href="manifest.json" />
    <title>React App</title>
  </head>
  <body>
    <noscript>You need to enable JavaScript to run this app.</noscript>
    <div id="root"></div>
    <script src="bundle.js"></script>
  </body>
</html>

５. react-create-app の実行

react-create-app で作成したアプリを実際に実行します。ついでに、ホットリロード機能が有効になっているかも確認します。

$ yarn webpack serve

Demo

ファイルに変更を加えてから保存すると、内容が即座に更新されているかと思います。

ホットリロード、気持ちよすぎだろ…

    ↓ me ↓
　　　*'``・*。
　　　 |　　　 `*。
　　,。∩　　　　*
+　 (´∀｀ ) *。+゜
`*。 ヽ、　つ *゜*
　 `・+。*・'⊃+゜
　 ☆　　∪~

最後に

以上となります。webpack-dev-server を使った React + TypeScript の開発環境の構築方法をご紹介いたしました。

「ホットリロードといえば、 Flutter」みたいなイメージが強かったですが React にもあるんですね〜✨

最後まで記事をご購読いただきありがとうございました。