メインコンテンツまでスキップ

ESLint

Next.js は、デフォルトで統合された ESLint の体験を提供しています。package.jsonnext lint をスクリプトとして追加します:

package.json
{
"scripts": {
"lint": "next lint"
}
}

次に、npm run lintまたはyarn lintを実行します:

Terminal
yarn lint

まだアプリケーションで ESLint が設定されていない場合は、インストールと設定プロセスのガイドが始まります。

Terminal
yarn lint

以下のようなプロンプトが表示されます:

? How would you like to configure ESLint?

❯ Strict (recommended) Base Cancel

次の3つのオプションから1つを選択できます:

  • Strict: Next.js のベースとなる ESLint 設定と、より厳格なCore Web Vitals ルールセットが含まれます。ESLint のセットアップをはじめて行う開発者に推奨される設定です。

    .eslintrc.json
    {
    "extends": "next/core-web-vitals"
    }
  • Base: Next.js のベースとなる ESLint 設定が含まれます。

    .eslintrc.json
    {
    "extends": "next"
    }
  • Cancel: ESLint の設定は何も含まれません。自身でカスタムの ESLint 設定する場合にのみ、このオプションを選択してください。

上2つの設定オプションのいずれかが選択された場合、Next.jsは自動的にeslinteslint-config-nextをアプリケーションの依存関係としてインストールし、選択した設定を含む.eslintrc.jsonファイルをプロジェクトのルートに作成します。

これで、エラーを検出するために ESLint を実行するたびにnext lintを実行できます。ESLint がセットアップされると、すべてのビルド(next build)でも自動的に実行されます。エラーはビルドに失敗しますが、警告は失敗しません。

next build中に ESLint を実行したくない場合は、ESLintを無視するを参照してください。

開発中に直接コードエディターで警告とエラーを表示するために、適切なインテグレーションを推奨します。

ESLint Config

デフォルトの設定(eslint-config-next)には、Next.js で最適な Lint 体験を初期状態で持つために必要なすべてが含まれています。アプリケーションでまだ ESLint が設定されていない場合、この設定と一緒にnext lintを使用して ESLint をセットアップすることを推奨します。

eslint-config-nextを他の ESLint の設定と一緒に使用したい場合は、追加の設定セクションを参照して、衝突を引き起こさずにそれを行う方法を学んでください。

下記の ESLint プラグインから推奨されるルールセットはすべてeslint-config-next内で使用されています:

この設定は next.config.js の設定より優先されます。

ESLint Plugin

Next.js では ESLint プラグイン、eslint-plugin-next を提供しており、ベースの設定内にすでにバンドルされています。Next.js アプリケーション内で一般的な問題や問題を検出できます。全ルールセットは以下のとおりです:

✅ 推奨設定では有効

ルール説明
@next/next/google-font-displayGoogle Fontsとのfont-displayの挙動を指定します
@next/next/google-font-preconnectGoogle Fontsとのpreconnectの使用を確認します
@next/next/inline-script-idインラインコンテンツに対するnext/scriptコンポーネントのid属性を指定します
@next/next/next-script-for-gaGoogle Analyticsのインラインスクリプトを使用する際にはnext/scriptコンポーネントを優先します
@next/next/no-assign-module-variablemodule変数への代入を防止します
@next/next/no-async-client-componentClient Componentが非同期関数であることを防止します
@next/next/no-before-interactive-script-outside-documentpages/_document.jsの外部でnext/scriptbeforeInteractive戦略の使用を防止します
@next/next/no-css-tags手動のスタイルシートタグの使用を防止します
@next/next/no-document-import-in-pagepages/_document.js以外でのnext/documentのインポートを防止します
@next/next/no-duplicate-headpages/_document.jsでの<Head>の重複使用を防止します
@next/next/no-head-element<head>要素の使用を防止します
@next/next/no-head-import-in-documentpages/_document.jsでのnext/headの使用を防止します
@next/next/no-html-link-for-pages内部のNext.jsページに移動するための<a>要素の使用を防止します
@next/next/no-img-elementLCPが遅くなるか、帯域幅が高くなる可能性があるため、<img>要素の使用を防止します
@next/next/no-page-custom-fontページ限定のカスタムフォントの使用を防止します
@next/next/no-script-component-in-headnext/headコンポーネント内でのnext/scriptの使用を防止します
@next/next/no-styled-jsx-in-documentpages/_document.jsでのstyled-jsxの使用を防止します
@next/next/no-sync-scripts同期スクリプトの使用を防止します
@next/next/no-title-in-document-headnext/documentからのHeadコンポーネントと一緒に使用される<title>の使用を防止します
@next/next/no-typosNext.jsのfetch関数内の一般的なタイプミスを防止します
@next/next/no-unwanted-polyfillioPolyfill.ioからの重複したポリフィルの使用を防止します

アプリケーションですでに ESLint が設定されている場合、eslint-config-next を含めるのではなく、このプラグインから直接拡張することを推奨します。詳細については、推奨されるプラグインのルールセットを参照してください。

カスタム設定

rootDir

eslint-plugin-next をモノレポなど、Next.js がルートディレクトリにインストールされていないプロジェクトで使用している場合、.eslintrcsettings プロパティを使用して eslint-plugin-next にNext.jsのアプリケーションがどこにあるかを伝えることができます:

.eslintrc.json
{
"extends": "next",
"settings": {
"next": {
"rootDir": "packages/my-app/"
}
}
}

rootDirはパス(相対または絶対)、glob(例えば "packages/*/")、またはパスあるいは glob の配列を指定できます。

カスタムディレクトリとファイルの Lint

デフォルトでは、Next.js は pages/app/components/lib/、およびsrc/ディレクトリ内のすべてのファイルで ESLint を実行します。しかし、next.config.jseslint設定のdirsオプションを使用して、本番ビルドでどのディレクトリを対象にするかを指定できます:

next.config.js
module.exports = {
eslint: {
dirs: ['pages', 'utils'], // 本番ビルド (next build) の間は、'pages' と 'utils' ディレクトリでのみ ESLint を実行します
},
}

同様に、next lint に対して --dir フラグと --file フラグを使用して特定のディレクトリやファイルをリントできます:

Terminal
next lint --dir pages --dir utils --file bar.js

キャッシング

パフォーマンス向上のため、ESLint が処理したファイルの情報はデフォルトでキャッシュされます。これは .next/cache または定義したビルドディレクトリに格納されます。もし1つのソースファイルの内容以上に依存する ESLint ルールを含めており、キャッシュを無効にする必要がある場合は、next lint--no-cacheフラグを使用してください。

Terminal
next lint --no-cache

ルールの無効化

サポートされているプラグイン(reactreact-hooksnext)によって提供される任意のルールを変更・無効化したい場合、.eslintrcrulesプロパティを直接使用して変更できます:

.eslintrc.json
{
"extends": "next",
"rules": {
"react/no-unescaped-entities": "off",
"@next/next/no-page-custom-font": "off"
}
}

Core Web Vitals

next/core-web-vitals ルールセットは、next lint が最初に実行され、strict オプションが選択されたとき有効なります。

.eslintrc.json
{
"extends": "next/core-web-vitals"
}

next/core-web-vitalsは、デフォルトでは警告となる数個のルールを、Core Web Vitalsに影響する場合はエラーとするようにeslint-plugin-nextを更新します。

新しいアプリケーションを Create Next App でビルドした場合、next/core-web-vitals エントリーポイントは自動的に含まれます。

他のツールとの使用

Prettier

ESLintにはコードのフォーマット指定ルールも含まれていますが、すでに設定されている Prettier と競合する可能性があります。そこで、ESLint と Prettier を一緒に動かすため、 ESLint の設定にeslint-config-prettierを含めることを推奨します。

まず、依存関係をインストールします:

Terminal
npm install --save-dev eslint-config-prettier

yarn add --dev eslint-config-prettier

pnpm add --save-dev eslint-config-prettier

bun add --dev eslint-config-prettier

次に、既存の ESLint の設定に prettier を追加します:

.eslintrc.json
{
"extends": ["next", "prettier"]
}

lint-staged

next lintlint-staged と同時に使い、ステージングされた git ファイル上でリンターを走らせたい場合があります。--file フラグの使用を明示するためにプロジェクト・ルートの .lintstagedrc.js ファイルに以下の内容を追加する必要があります。

.lintstagedrc.js
const path = require('path')

const buildEslintCommand = (filenames) =>
`next lint --fix --file ${filenames
.map((f) => path.relative(process.cwd(), f))
.join(' --file ')}`

module.exports = {
'*.{js,jsx,ts,tsx}': [buildEslintCommand],
}

既存の設定の移行

推奨されるプラグインのルールセット

すでに ESLint がアプリケーションに設定されていて、以下の条件のうち1つ以上に当てはまる場合:

  • 以下のプラグインのうち 1 つ以上がすでにインストールされている(airbnbreact-appなどの別の設定を介してインストールされている場合も含む):
    • react
    • react-hooks
    • jsx-a11y
    • import
  • Babel が Next.js 内で設定されている方法と異なる特定の parserOptions が定義されている(Next.js のBabelの設定をカスタマイズしていない限り非推奨です)
  • Node.js と eslint-plugin-importがインストールされている、あるいは TypeScript リゾルバがインポートを処理するように定義されている

eslint-config-next 内で上記のプロパティが設定された方法を優先する場合、上記設定のどれかを削除してください。または、直接 Next.js ESLint プラグインから拡張することを推奨します:

module.exports = {
extends: [
//...
'plugin:@next/next/recommended',
],
}

プラグインは next lint を実行せずに通常通りプロジェクトへインストールできます:

Terminal
npm install --save-dev @next/eslint-plugin-next

yarn add --dev @next/eslint-plugin-next

pnpm add --save-dev @next/eslint-plugin-next

bun add --dev @next/eslint-plugin-next

これにより、同じプラグインやパーサーを複数の設定からインポートして生じる可能性のある衝突やエラーを避けることができます。

追加の設定

すでに別のESLintの設定を使用しており、eslint-config-nextを含めたい場合、例えば以下のように、他の設定の後で最後に拡張されるよう設定してください:

.eslintrc.json
{
"extends": ["eslint:recommended", "next"]
}

next設定ではparserpluginssettingsプロパティのデフォルト値の設定をすでに処理しています。使用ケースに応じてこれらのプロパティを手動で再宣言する必要はありません。

それ以外の共有設定を含める場合は、これらのプロパティが上書きや修正されないように注意する必要があります。そうでなければ、next 設定と同じ動作を共有する設定を削除するか、上記で述べたように Next.js ESLint プラグインから直接拡張することを推奨します。