17

Just a simple question to clarify what does parameter "done" in a gulp task do?

I understand, this is the callback in task function as shown below.

gulp.task('clean', function(done) {
    // so some stuff
    creategulptask(cleantask(), done);
});

But what is the reason to pass it?

1 Answer 1

26

The gulp documentation specifies something similar to the following:

var gulp = require('gulp');

// Takes in a callback so the engine knows when it'll be done
// This callback is passed in by Gulp - they are not arguments / parameters
// for your task.
gulp.task('one', function(cb) {
    // Do stuff -- async or otherwise
    // If err is not null and not undefined, then this task will stop, 
    // and note that it failed
    cb(err); 
});

// Identifies a dependent task must be complete before this one begins
gulp.task('two', ['one'], function() {
    // Task 'one' is done now, this will now run...
});

gulp.task('default', ['one', 'two']);

The done argument is passed into the callback function you use to define your tasks.

Your task function can "accept a callback" function parameter (often this function parameter is named done). Executing that done function tells Gulp "a hint to tell it when the task is done".

Gulp needs this hint if you want to order a series of tasks that depend on each other, as shown in the above example. (i.e. task two won't begin until task one calls cb()) In essence, it stops tasks from running concurrently if you don't want them to.

You can read more about this here: https://github.com/gulpjs/gulp/blob/master/docs/API.md#async-task-support

Sign up to request clarification or add additional context in comments.

5 Comments

Nicely Explained. Thanks @Seer
Just curious, how does gulp check and know, if the function I give to him has a parameter or not? How is this possible in Javascript? This sounds like reflection.
The callback is particularly useful if you need to run an async process inside the task, while you want the task to wait for that to complete, before returning. Otherwise, just returning the stream might be enough. See also github.com/gulpjs/gulp/blob/master/docs/…
@HolgerThiemann internally, gulp can receive the function passed and check its length attribute to see the amount of expected parameters.
Encourage people to check out the documentation; there are 2 alternatives to the "done callback" technique. First alternative: return a stream. Second alternative: return a promise.

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.