node package manager

grunt-esmangle

A Grunt plugin for mangling or minifying JavaScript files using Esmangle

grunt-esmangle

A Grunt plugin for mangling or minifying JavaScript files using Esmangle.

This plugin requires Grunt v0.4.0+.

If you haven’t used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you’re familiar with that process, you may install this plugin with this command:

npm install grunt-esmangle --save-dev

One the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-esmangle');

In your project’s Gruntfile, add a section named esmangle to the data object passed into grunt.initConfig().

grunt.initConfig({
'esmangle': {
'options': {
// Task-specific options go here 
},
'your-target': {
'options': {
// Target-specific options go here 
},
'files': {
// Target-specific file lists go here 
}
}
}
});

The options property accepts all the available Escodegen options. See the Escodegen wiki for an overview.

Additionally, there are two Grunt-specific options:

Type: String Default: empty string

This string will be prepended to the beginning of the mangled/minified output. It is processed using grunt.template.process, using the default options.

(Default processing options are explained in the grunt.template.process documentation.)

Choices: false, 'min', 'gzip' Default: false

Either do not report anything, report only minification result, or report minification and gzip results.

Important: including 'gzip' results can make this task 5-10× slower depending on the size of the file.

Here’s a practical example of grunt-esmangle:

grunt.initConfig({
'esmangle': {
'options': {
// Don’t preserve semicolons at the end of blocks and programs 
'semicolons': false
},
'minify-plugins': {
'options': {
// Always use double quotes as string literal delimiter 
'quotes': 'double'
},
'files': {
'dist/all-plugins.min.js': ['js/plugins/*.js']
}
},
'minify-custom-scripts': {
'options': {
// Preserve comments 
'comment': true
},
'files': {
'dist/all-custom-scripts.min.js': ['js/custom-scripts/*.js']
}
}
}
});
Mathias Bynens

grunt-esmangle is dual licensed under the MIT and GPL licenses.