Builds projects using require.js's optimizer
|Description||uses require.js's r.js optimizer to combine require.js AMD modules into one file|
|Node Version||≧ 4|
gulp-requirejs as a dev-dependency in your package.json or run
$ npm install --save-dev gulp-requirejs
Because the require.js optimizer (r.js) is a kind of build system in itself we can't use the
gulp.src([...]) syntax at the moment (I might add this in future), instead this wrapper itself emits a pipable stream, holding a 'virtual' file, in which the result of the r.js build process are saved.
The resulting stream can be treated like a regular
NOTE: The built in minification/obfuscation is deactivated by default. It is recommended to use a gulp plugin like gulp-uglify for minification, but you can enable r.js minification by setting the
uglifyto minify using r.js.
var gulp =rjs = ;gulp;
Note: In order to let gulp know that the optimization completes, return the rjs stream.
gulp-requirejs will emit errors when you don't pass an options object and if the
out properties are undefined.
The require.js optimizer itself might also emit errors; unfortunately there's no way of catching them elegantly at the moment.
When source maps are enabled via the r.js
generateSourceMaps option the stream returned by
rjs() contains an additional file named the same as the
out option with
Use gulp-sourcemaps to use this file in your gulp configuration:
var gulp =rjs =sourcemaps = ;gulp;
The options object supports the same parameters as the require.js optimizer.