⚠️ You are looking at the english version of the page. Help us translate it here.

How to extend webpack config?

You can extend nuxt's webpack configuration via the extend option in your nuxt.config.js. The extend option of the build property is a method that accepts two arguments. The first argument is the webpack config object exported from nuxt's webpack config. The second parameter is a context object with the following boolean properties: { isDev, isClient, isServer, loaders }.

export default {
  build: {
    extend (config, { isDev, isClient }) {
      // ..
      config.module.rules.push(
        {
          test: /\.(ttf|eot|svg|woff(2)?)(\?[a-z0-9=&.]+)?$/,
          loader: 'file-loader'
        }
      )
      // Sets webpack's mode to development if `isDev` is true.
      if (isDev) { config.mode = 'development' }
    }
  }
}

The extend method gets called twice - Once for the client bundle and the other for the server bundle.

Examples

Customize chunks configuration

You may want to tweak a bit optimization configuration, avoiding to rewrite default object.

export default {
  build: {
    extend (config, { isClient }) {
      if (isClient) {
          config.optimization.splitChunks.maxSize = 200000;
      }
    }
  }
}

Execute ESLint on every webpack build in dev environment

In order to be aware of code style errors, you may want to run ESLint on every build in dev environment.

export default {
  build: {
    extend (config, { isDev, isClient }) {
      if (isDev && isClient) {
          config.module.rules.push({
              enforce: 'pre',
              test: /\.(js|vue)$/,
              loader: 'eslint-loader',
              exclude: /(node_modules)/,
          });
      }
    }
  }
}

Contributors

Jumpa kesalahan atau ingin berkontribusi pada dokumentasi ini? Sunting halaman ini di GitHub!

Platinum Sponsors

Storyblok Support Us