The ModuleContainer Class
- Source: core/module.js
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)
Deprecated as vendor
isn't used anymore
Adds to options.build.vendor
and apply unique filter.
addTemplate (template)
- template:
String
orObject
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 { dst, 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.
extendPlugins (fn)
Allows easily extending plugins by chaining options.extendPlugins function.
addModule (moduleOpts, requireOnce)
Async function
Registers a module. moduleOpts
can be a string or an array ([src, options]
). If requireOnce
is true
and the resolved module exports meta
, it prevents registering same module twice.
requireModule (moduleOpts)
Async function
Is a shortcut for 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 have been loaded. |