deferred.done()S2C Home « Objects « deferred.done()
doneCallbacks additions.
Description
The deferred.done() Deferred method, adds handlers to be called when the Deferred object is resolved.
- When the Deferred is resolved, doneCallbacks are executed in the order they were added, using the arguments provided to the
deferred.resolve()ordeferred.resolveWith()methods.
Syntax
| Signature | Description |
|---|---|
deferred.done( doneCallbacks ) | Add handlers to be called when the Deferred object is resolved. |
Parameters
| Parameter | Description | Type |
|---|---|---|
doneCallbacks | A function(s), or array(s) of functions, that are called when the Deferred
is resolved. | Function |
Return
A Deferred object.
deferred.done( doneCallbacks ) ExampleTop
Add handlers to be called when the Deferred object is resolved.
In the example below when we press the left button the first time we create a Deferred object and use some deferred object methods on it. We then resolve the
Deferred object and hence deferred.done( doneCallbacks ) gets called with the message passed from the resolve.
When we press the right button the first time we create a Deferred object and use some deferred object methods on it. We then reject the
Deferred object and hence deferred.fail( failCallbacks ) gets called with the message passed from the reject.
$(function(){
$('#btn5').one('click', function(){
var ourDeferred = $.Deferred();
ourDeferred.done( cFunc );
ourDeferred.fail( dFunc );
ourDeferred.progress( cFunc, dFunc );
ourDeferred.notify( 'function was fired from our deferred. <br>', '#div1');
ourDeferred.resolve( 'Our deferred was resolved. <br> <br>', '#div1' );
});
$('#btn6').one('click', function(){
var ourDeferred = $.Deferred();
ourDeferred.done( cFunc );
ourDeferred.fail( dFunc );
ourDeferred.progress( cFunc, dFunc );
ourDeferred.notify( 'function was fired from our deferred. <br>', '#div1');
ourDeferred.reject( 'Our deferred was rejected. <br> <br>', '#div1' );
});
function cFunc( value, div ){
$(div).append( 'In cFunc: ' + value);
}
function dFunc( value, div ){
$(div).append( 'In dFunc: ' + value);
}
});
div1. Some initial text.