ModuleContainer Class

All modules will be called within context of ModuleContainer instance.

Tapable plugins

We can register hooks on certain life cycle events.

nuxt.moduleContainer.plugin('ready', async moduleContainer => {
    // Do this after all modules where ready
})

Inside modules context we can use this instead:

this.plugin('ready', async moduleContainer => {
    // Do this after all modules where ready
})
Plugin Arguments When
ready moduleContainer All modules in nuxt.config.js has been initialized

Methods

addVendor (vendor)

Adds to options.build.vendor and apply unique filter.

addTemplate (template)

  • template: String or Object
    • src
    • options
    • fileName

Renders given template using lodash template during build into project buildDir (.nuxt).

If fileName is not provided or template is string, target file name defaults to [dirName].[fileName].[pathHash].[ext].

This method returns final { dist, src, options } object.

addPlugin (template)

Registers a plugin using addTemplate and adds it to first of plugins[] option.

You can use template.ssr: false to disable plugin including in SSR bundle.

addServerMiddleware (middleware)

Pushes middleware into options.serverMiddleware.

extendBuild (fn)

Allows easily extending webpack build config by chaining options.build.extend function.

extendRoutes (fn)

Allows easily extending routes by chaining options.build.extendRoutes function.

addModule (moduleOpts, requireOnce)

Registers module. moduleOpts can be string or [src, options]. If requireOnce is true and resolved module exports meta prevents registering same module twice.

requireModule (moduleOpts)

Is shortcut to addModule(moduleOpts, true)

Hooks

We can register hooks on certain life cycle events.

Hook Arguments When
modules:before (moduleContainer, options) Called before creating ModuleContainer class, useful to overload methods and options.
modules:done (moduleContainer) Called when all modules has been loaded.

Caught a mistake or want to contribute to the documentation? Edit this page on GitHub!