Lang x Lang

next.config.js Options

Next.js は、プロジェクトディレクトリの root (例えば、package.jsonによって)にあるnext.config.jsファイルを通じて設定できます。これは、 default export によるものです。

next.config.js
// @ts-check

/** @type {import('next').NextConfig} */
const nextConfig = {
  /* config options here */
}

module.exports = nextConfig

next.config.jsは通常の Node.js モジュールであり、JSON ファイルではありません。これは Next.js server と build フェーズによって使用され、ブラウザの build には含まれていません。

もしあなたがECMAScript modules が必要な場合、next.config.mjsを使用することができます:

next.config.mjs
// @ts-check

/**
 * @type {import('next').NextConfig}
 */
const nextConfig = {
  /* config options here */
}

export default nextConfig

あなたはまた、関数を使用することもできます:

next.config.mjs
// @ts-check

export default (phase, { defaultConfig }) => {
  /**
   * @type {import('next').NextConfig}
   */
  const nextConfig = {
    /* config options here */
  }
  return nextConfig
}

Next.js12.1.0 以降、あなたは async 関数を使うことができます。

next.config.js
// @ts-check

module.exports = async (phase, { defaultConfig }) => {
  /**
   * @type {import('next').NextConfig}
   */
  const nextConfig = {
    /* config options here */
  }
  return nextConfig
}

phaseは、設定がロードされる現在の context です。利用可能なフェーズ を見ることができます。フェーズはnext/constantsからインポートすることができます。

// @ts-check

const { PHASE_DEVELOPMENT_SERVER } = require("next/constants");

module.exports = (phase, { defaultConfig }) => {
  if (phase === PHASE_DEVELOPMENT_SERVER) {
    return {
      /* development only config options here */
    };
  }

  return {
    /* config options for all phases except development here */
  };
};

コメントされた行は、next.config.jsで許可されている設定を置くことができる場所であり、それらはこのファイルで定義されています

ただし、config はいずれも必須ではなく、各々の config が何をするのかを理解する必要はありません。代わりに、このセクションで有効にしたり、修正したりする必要のある機能を探し、それらが何をするべきかを示します。

あなたの target Node.js version で利用できない新しい JavaScript の特徴を使用するのは避けてください。next.config.js は Webpack、Babel、または TypeScript によって解析されません。

このページは、利用可能なすべての設定の options を文書化しています:

当社サイトでは、Cookie を使用しています。各規約をご確認の上ご利用ください:
Cookie Policy, Privacy Policy および Terms of Use