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:
StringorObjectsrcoptionsfileName
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. |
Contributors
Debbie O'Brien
Paul Melero
pooya parsa
Sébastien Chopin
Benjamin Canac
fgiraud
Sergey Bedritsky
Alba Silvente Fuentes
Alexander Lichter
Krutie Patel
Daniel Roe
Pim
Ahad Birang
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub!
