What is moment-locales-webpack-plugin?
The moment-locales-webpack-plugin is a Webpack plugin designed to optimize the Moment.js library by removing unused locales. This helps reduce the bundle size of your application, making it more efficient.
What are moment-locales-webpack-plugin's main functionalities?
Remove Unused Locales
This feature allows you to remove all unused locales from Moment.js, reducing the bundle size significantly.
const MomentLocalesPlugin = require('moment-locales-webpack-plugin');
module.exports = {
plugins: [
new MomentLocalesPlugin()
]
};
Keep Specific Locales
This feature allows you to specify which locales you want to keep in your bundle. In this example, only 'es-us' and 'ru' locales are kept.
const MomentLocalesPlugin = require('moment-locales-webpack-plugin');
module.exports = {
plugins: [
new MomentLocalesPlugin({
localesToKeep: ['es-us', 'ru']
})
]
};
Other packages similar to moment-locales-webpack-plugin
babel-plugin-lodash
The babel-plugin-lodash is a Babel plugin that cherry-picks Lodash modules to reduce bundle size. While it is not specifically for Moment.js, it serves a similar purpose of optimizing library imports to reduce bundle size.
moment-locales-webpack-plugin
Easily remove unused Moment.js locales when building with webpack
Why
75% (160 minified KBs)¹ of Moment.js’ size are files used for localization. They are always included when you build your app with webpack.
You don’t need most of these files if your app is only available in a few languages. Use this plugin to strip these KBs and optimize the app!
¹ – tested with Moment.js 2.18.1
Install
npm install --save-dev moment-locales-webpack-plugin
Usage
const MomentLocalesPlugin = require('moment-locales-webpack-plugin');
module.exports = {
plugins: [
new MomentLocalesPlugin(),
new MomentLocalesPlugin({
localesToKeep: ['es-us', 'ru'],
}),
],
};
Plugin Options
localesToKeep: String[]
An array of locales to keep bundled (other locales would be removed).
Locale names follow Moment.js behavior – if a specific locale name (e.g. ru-ru
) is absent, but a more generic locale (ru
) is available, the generic one will be kept bundled.
ignoreInvalidLocales: Boolean
A flag to ignore invalid or unsupported locales in the localesToKeep
array.
Be careful! A typo in the localesToKeep
array with this flag enabled will silently exclude the desired locale from your bundle.
Related projects
Contributing
See CONTRIBUTING.md for how to contribute.
License
MIT © Ivan Akulov