Skip to content
main
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Webpack module-nomodule plugin

npm version

Installation

npm install --save-dev webpack-module-nomodule-plugin

or

yarn add -D webpack-module-nomodule-plugin

Why

This automates the generation of module-nomodule scripts.

This project relies on html-webpack-plugin.

module-nomodule explained.

How to use

The only thing you need to do is return two build steps in your webpack and forward this to this plugin like this:

  • for legacy new WebpackModuleNomodulePlugin('legacy');
  • for modern new WebpackModuleNomodulePlugin('modern');

The rest will be handled for you!

Output modes

The second argument to WebpackModuleNomodulePlugin allows you to specify an output mode.

At this point there are two:

  • efficient (default)
  • minimal

These are exported as an object containing OUTPUT_MODES.

Efficient

Ensures IE11 and some Edge versions won't double download the contents of your scripts. This adds some more size to your html file and defers the loading of scripts.

This will look something like this:

efficient mode output

What happens in this picture?

  • We declare the modern javascript files as modulepreload to shave a bit off the load/parse time of these
  • We dynamically inject the entry-modules with the bigger script to avoid injecting needlessly

Minimal

Makes the most minimal output possible, this will be downloaded twice on older Edge and IE11.

This will look something like this:

minimal mode output

The script in the middle between type="module" and nomodule is meant for safari 11 compat.

nomodule will load for browsers who don't support module and the other way around, the problem with this approach is we'll be downloading both bundles on certain Edge versions and IE11.

Example

https://github.com/JoviDeCroock/POC-ModularLegacyBuild

This example uses multiple techniques to guarantee the best size, like using native-url in modern browsers, ...

About

Easily implement a module nomodule index.html

Resources

Sponsor this project

 

Packages

No packages published