jQuery deferreds and promises – .then() vs .done()

by

The callbacks attached to done() will be fired when the deferred is resolved. The callbacks attached to fail() will be fired when the deferred is rejected.

Prior to jQuery 1.8, then() was just syntactic sugar:

promise.then( doneCallback, failCallback )
// was equivalent to
promise.done( doneCallback ).fail( failCallback )

As of 1.8, then() is an alias for pipe() and returns a new promise, see here for more information on pipe().

success() and error() are only available on the jqXHR object returned by a call to ajax(). They are simple aliases for done() and fail() respectively:

jqXHR.done === jqXHR.success
jqXHR.fail === jqXHR.error

Also, done() is not limited to a single callback and will filter out non-functions (though there is a bug with strings in version 1.8 that should be fixed in 1.8.1):

// this will add fn1 to 7 to the deferred's internal callback list
// (true, 56 and "omg" will be ignored)
promise.done( fn1, fn2, true, [ fn3, [ fn4, 56, fn5 ], "omg", fn6 ], fn7 );

Same goes for fail().

More Related Contents:

  1. Problems inherent to jQuery $.Deferred (jQuery 1.x/2.x)
  2. jQuery: execute array of functions sequentially (both deferreds and non-deferreds)
  3. How to properly break out of a promise chain?
  4. How do you work with an array of jQuery Deferreds? [duplicate]
  5. jQuery Deferred – waiting for multiple AJAX requests to finish [duplicate]
  6. $.Deferred: How to detect when every promise has been executed
  7. How to make all AJAX calls sequential?
  8. what is difference between success and .done() method of $.ajax
  9. When should I use jQuery deferred’s “then” method and when should I use the “pipe” method?
  10. What are deferred objects?
  11. How to chain ajax calls using jquery
  12. jQuery.when understanding
  13. jQuery jqXHR – cancel chained calls, trigger error chain
  14. How to select all images using jquery and give them an width?
  15. Difference between .on(‘click’) vs .click()
  16. What is the difference between these jQuery ready functions?
  17. Trigger click on input=file on asynchronous ajax done()
  18. jQuery or CSS selector to select all IDs that start with some string [duplicate]
  19. jQuery ajax success anonymous function scope
  20. Can you detect “dragging” in jQuery?
  21. Check if username exists in database with AJAX
  22. append /remove anchor name from current url without refresh
  23. How can I change HTML attribute names with jQuery?
  24. A cleaner way to select by multiple possible attribute values?
  25. Remove CSS “top” and “left” attributes with jQuery
  26. jQuery: using a variable as a selector [duplicate]
  27. jquery validation not waiting for remote validation to return true, considers form valid
  28. Selecting a jQuery Tab using a parameter in the URL
  29. Using jQuery’s $.ajax within an angularJS controller
  30. Load JQuery into a Chrome extension?

Leave a Comment