Runs a sequence of gulp tasks in the specified order. This function is designed to solve the situation where you have defined run-order, but choose not to or cannot use dependencies.
Is your company hiring Node developers?
If you are hiring developers, you can support this project and future open source work by checking out our company, Qualified.io.
Qualified is a service for online skills-assessment that can help you easily vet developers across a wide range of real-world programming skills.
Please help support this project, and sign up for a free trial.
Each argument to
run-sequence is run in order. This works by listening to the
task_err events, and keeping track of which tasks have been completed. You can still run some of the tasks in parallel, by providing an array of task names for one or more of the arguments.
If the final argument is a function, it will be used as a callback after all the functions are either finished or an error has occurred.
This was intended to be a temporary solution until the release of gulp 4.0 which should have support for defining task dependencies similarly.
Given that Gulp 4 appears to never be fully released, take that for what you will. Be aware that this solution is a hack, and may stop working with a future update to gulp.
run-sequence as a development dependency:
npm install --save-dev run-sequence
Then add use it in your gulpfile, like so (note these are only examples, please check the documentation for your functions for the correct way to use them):
var gulp = ;var runSequence = ;var del = ;var fs = ;// This will run in this order:// * build-clean// * build-scripts and build-styles in parallel// * build-html// * Finally call the callback functiongulp;// configure build-clean, build-scripts, build-styles, build-html as you wish,// but make sure they either return a stream or promise, or handle the callback// Example:gulp;gulp;gulp;
Using within gulp submodules
If you have a complex gulp setup with your tasks split up across different files, you may get the error that
run-sequence is unable to find your tasks. In this case, you can configure
run-sequence to look at the gulp within the submodule, like so:
// submodule tasks/mygulptask.jsvar gulp = // might be a different instance than the toplevel one// this uses the gulp you providerunSequence = ;// ...and then use normally;
There are a few global options you can configure on the
Please note these are global to the module, and once set will affect every use of
var runSequence = ;runSequenceoptionsignoreUndefinedTasks = true;gulp
showErrorStackTrace: When set to
false, this suppresses the full stack trace from errors captured during a sequence.
ignoreUndefinedTasks: When set to
true, this enables you to pass falsey values in which will be stripped from the task set before validation and sequencing.