gulp-uglify

Minify JavaScript with UglifyJS3.

Installation

Install package with NPM and add it to your development dependencies:

npm install --save-dev gulp-uglify

Usage

1var gulp = require('gulp');
2var uglify = require('gulp-uglify');
3var pipeline = require('readable-stream').pipeline;
4
5gulp.task('compress', function () {
6  return pipeline(
7        gulp.src('lib/*.js'),
8        uglify(),
9        gulp.dest('dist')
10  );
11});

To help properly handle error conditions with Node streams, this project recommends the use of pipeline, from readable-stream.

Options

Most of the minify options from the UglifyJS API are supported. There are a few exceptions:

1. The sourceMap option must not be set, as it will be automatically configured based on your Gulp configuration. See the documentation for Gulp sourcemaps.

Errors

gulp-uglify emits an 'error' event if it is unable to minify a specific file. The GulpUglifyError constructor is exported by this plugin for instanceof checks. It contains the following properties:

• fileName: The full file path for the file being minified.
• cause: The original UglifyJS error, if available.

Most UglifyJS error messages have the following properties:

• message (or msg)
• filename
• line

To see useful error messages, see Why Use Pipeline?.

Using a Different UglifyJS

By default, gulp-uglify uses the version of UglifyJS installed as a dependency. It's possible to configure the use of a different version using the "composer" entry point.

1var uglifyjs = require('uglify-js'); // can be a git checkout
2                                     // or another module (such as `uglify-es` for ES6 support)
3var composer = require('gulp-uglify/composer');
4var pump = require('pump');
5
6var minify = composer(uglifyjs, console);
7
8gulp.task('compress', function (cb) {
9  // the same options as described above
10  var options = {};
11
12  pump([
13      gulp.src('lib/*.js'),
14      minify(options),
15      gulp.dest('dist')
16    ],
17    cb
18  );
19});