Introduced a new promise method on deferreds that returns an immutable object (exposing then, fail, isResolved, isRejected and promise itself only). Remove $.isDeferred and moved logic directly into $.when. Made sure $.when returns a promise by using promise(). Used promise() in ajax code too.
This commit is contained in:
parent
6165cc45b7
commit
6dbffb8596
3 changed files with 47 additions and 48 deletions
|
@ -490,8 +490,9 @@ jQuery.extend({
|
||||||
}
|
}
|
||||||
|
|
||||||
// Attach deferreds
|
// Attach deferreds
|
||||||
jXHR.success = jXHR.then = deferred.then;
|
deferred.promise( jXHR );
|
||||||
jXHR.error = jXHR.fail = deferred.fail;
|
jXHR.success = jXHR.then;
|
||||||
|
jXHR.error = jXHR.fail;
|
||||||
jXHR.complete = completeDeferred.then;
|
jXHR.complete = completeDeferred.then;
|
||||||
|
|
||||||
// Remove hash character (#7531: and string promotion)
|
// Remove hash character (#7531: and string promotion)
|
||||||
|
|
30
src/core.js
30
src/core.js
|
@ -78,7 +78,7 @@ var jQuery = function( selector, context ) {
|
||||||
class2type = {},
|
class2type = {},
|
||||||
|
|
||||||
// Marker for deferred
|
// Marker for deferred
|
||||||
deferredMarker = [];
|
promiseMarker = [];
|
||||||
|
|
||||||
jQuery.fn = jQuery.prototype = {
|
jQuery.fn = jQuery.prototype = {
|
||||||
init: function( selector, context ) {
|
init: function( selector, context ) {
|
||||||
|
@ -896,9 +896,6 @@ jQuery.extend({
|
||||||
}
|
}
|
||||||
};
|
};
|
||||||
|
|
||||||
// Add the deferred marker
|
|
||||||
deferred.then._ = deferredMarker;
|
|
||||||
|
|
||||||
return deferred;
|
return deferred;
|
||||||
},
|
},
|
||||||
|
|
||||||
|
@ -916,7 +913,16 @@ jQuery.extend({
|
||||||
fail: errorDeferred.then,
|
fail: errorDeferred.then,
|
||||||
fireReject: errorDeferred.fire,
|
fireReject: errorDeferred.fire,
|
||||||
reject: errorDeferred.resolve,
|
reject: errorDeferred.resolve,
|
||||||
isRejected: errorDeferred.isResolved
|
isRejected: errorDeferred.isResolved,
|
||||||
|
// Get a promise for this deferred
|
||||||
|
// If obj is provided, the promise aspect is added to the object
|
||||||
|
promise: function( obj ) {
|
||||||
|
obj = obj || {};
|
||||||
|
for ( var i in { then:1 , fail:1 , isResolved:1 , isRejected:1 , promise:1 } ) {
|
||||||
|
obj[ i ] = deferred[ i ];
|
||||||
|
}
|
||||||
|
return obj;
|
||||||
|
}
|
||||||
|
|
||||||
} );
|
} );
|
||||||
|
|
||||||
|
@ -924,6 +930,9 @@ jQuery.extend({
|
||||||
delete deferred.cancel;
|
delete deferred.cancel;
|
||||||
delete deferred.isCancelled;
|
delete deferred.isCancelled;
|
||||||
|
|
||||||
|
// Add promise marker
|
||||||
|
deferred.promise._ = promiseMarker;
|
||||||
|
|
||||||
// Make sure only one callback list will be used
|
// Make sure only one callback list will be used
|
||||||
deferred.then( errorDeferred.cancel ).fail( successCancel );
|
deferred.then( errorDeferred.cancel ).fail( successCancel );
|
||||||
|
|
||||||
|
@ -935,17 +944,12 @@ jQuery.extend({
|
||||||
return deferred;
|
return deferred;
|
||||||
},
|
},
|
||||||
|
|
||||||
// Check if an object is a deferred
|
|
||||||
isDeferred: function( object ) {
|
|
||||||
return !!( object && object.then && object.then._ === deferredMarker );
|
|
||||||
},
|
|
||||||
|
|
||||||
// Deferred helper
|
// Deferred helper
|
||||||
when: function( object ) {
|
when: function( object ) {
|
||||||
object = jQuery.isDeferred( object ) ?
|
object = object && object.promise && object.promise._ === promiseMarker ?
|
||||||
object :
|
object :
|
||||||
jQuery.Deferred().resolve( object );
|
jQuery.Deferred().resolve( object );
|
||||||
return object;
|
return object.promise();
|
||||||
},
|
},
|
||||||
|
|
||||||
// Use of jQuery.browser is frowned upon.
|
// Use of jQuery.browser is frowned upon.
|
||||||
|
@ -966,9 +970,7 @@ jQuery.extend({
|
||||||
});
|
});
|
||||||
|
|
||||||
// Create readyList deferred
|
// Create readyList deferred
|
||||||
// also force $.fn.ready to be recognized as a defer
|
|
||||||
readyList = jQuery._Deferred();
|
readyList = jQuery._Deferred();
|
||||||
jQuery.fn.ready._ = deferredMarker;
|
|
||||||
|
|
||||||
// Populate the class2type map
|
// Populate the class2type map
|
||||||
jQuery.each("Boolean Number String Function Array Date RegExp Object".split(" "), function(i, name) {
|
jQuery.each("Boolean Number String Function Array Date RegExp Object".split(" "), function(i, name) {
|
||||||
|
|
|
@ -1022,42 +1022,38 @@ test("jQuery.Deferred()", function() {
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
test("jQuery.isDeferred()", function() {
|
|
||||||
|
|
||||||
expect( 10 );
|
|
||||||
|
|
||||||
var object1 = { then: function() { return this; } },
|
|
||||||
object2 = { then: function() { return this; } };
|
|
||||||
|
|
||||||
object2.then._ = [];
|
|
||||||
|
|
||||||
// The use case that we want to match
|
|
||||||
ok(jQuery.isDeferred(jQuery._Deferred()), "Simple deferred");
|
|
||||||
ok(jQuery.isDeferred(jQuery.Deferred()), "Failable deferred");
|
|
||||||
|
|
||||||
// Some other objects
|
|
||||||
ok(!jQuery.isDeferred(object1), "Object with then & no marker");
|
|
||||||
ok(!jQuery.isDeferred(object2), "Object with then & marker");
|
|
||||||
|
|
||||||
// Not objects shouldn't be matched
|
|
||||||
ok(!jQuery.isDeferred(""), "string");
|
|
||||||
ok(!jQuery.isDeferred(0) && !jQuery.isDeferred(1), "number");
|
|
||||||
ok(!jQuery.isDeferred(true) && !jQuery.isDeferred(false), "boolean");
|
|
||||||
ok(!jQuery.isDeferred(null), "null");
|
|
||||||
ok(!jQuery.isDeferred(undefined), "undefined");
|
|
||||||
|
|
||||||
object1 = {custom: jQuery._Deferred().then};
|
|
||||||
|
|
||||||
ok(!jQuery.isDeferred(object1) , "custom method name not found automagically");
|
|
||||||
});
|
|
||||||
|
|
||||||
test("jQuery.when()", function() {
|
test("jQuery.when()", function() {
|
||||||
|
|
||||||
expect( 2 );
|
expect( 14 );
|
||||||
|
|
||||||
|
var fakeDeferred = { then: function() { return this; } };
|
||||||
|
|
||||||
|
fakeDeferred.then._ = [];
|
||||||
|
|
||||||
|
// Some other objects
|
||||||
|
jQuery.each( {
|
||||||
|
|
||||||
|
"Object with then & no marker": { then: jQuery.noop },
|
||||||
|
"Object with then & marker": fakeDeferred,
|
||||||
|
"string 1/2": "",
|
||||||
|
"string 2/2": "some string",
|
||||||
|
"number 1/2": 0,
|
||||||
|
"number 2/2": 1,
|
||||||
|
"boolean 1/2": true,
|
||||||
|
"boolean 2/2": false,
|
||||||
|
"null": null,
|
||||||
|
"undefined": undefined,
|
||||||
|
"custom method name not found automagically": {custom: jQuery._Deferred().then}
|
||||||
|
|
||||||
|
} , function( message , value ) {
|
||||||
|
|
||||||
|
notStrictEqual( jQuery.when( value ) , value , message );
|
||||||
|
|
||||||
|
} );
|
||||||
|
|
||||||
var cache, i;
|
var cache, i;
|
||||||
|
|
||||||
for( i = 1 ; i < 3 ; i++ ) {
|
for( i = 1 ; i < 4 ; i++ ) {
|
||||||
jQuery.when( cache || jQuery.Deferred( function() {
|
jQuery.when( cache || jQuery.Deferred( function() {
|
||||||
this.resolve( i );
|
this.resolve( i );
|
||||||
}) ).then( function( value ) {
|
}) ).then( function( value ) {
|
||||||
|
|
Loading…
Reference in a new issue