class2type = {},
// Marker for deferred
- deferredMarker = [];
+ promiseMarker = [];
jQuery.fn = jQuery.prototype = {
init: function( selector, context ) {
jQuery.error( "Invalid JSON: " + data );
}
},
+
+ // Cross-browser xml parsing
+ // (xml & tmp used internally)
+ parseXML: function( data , xml , tmp ) {
+
+ if ( window.DOMParser ) { // Standard
+ tmp = new DOMParser();
+ xml = tmp.parseFromString( data , "text/xml" );
+ } else { // IE
+ xml = new ActiveXObject( "Microsoft.XMLDOM" );
+ xml.async = "false";
+ xml.loadXML( data );
+ }
+
+ tmp = xml.documentElement;
+
+ if ( ! tmp || ! tmp.nodeName || tmp.nodeName === "parsererror" ) {
+ jQuery.error( "Invalid XML: " + data );
+ }
+
+ return xml;
+ },
noop: function() {},
},
// Create a simple deferred (one callbacks list)
- _deferred: function( cancellable ) {
-
- // cancellable by default
- cancellable = cancellable !== false;
+ _Deferred: function() {
var // callbacks list
callbacks = [],
deferred = {
// then( f1, f2, ...)
- then: function then() {
+ then: function () {
if ( ! cancelled ) {
-
+
var args = arguments,
i,
length,
elem = args[ i ];
type = jQuery.type( elem );
if ( type === "array" ) {
- then.apply( this , elem );
+ deferred.then.apply( deferred , elem );
} else if ( type === "function" ) {
callbacks.push( elem );
}
deferred.fire( _fired[ 0 ] , _fired[ 1 ] );
}
}
+
return this;
},
// resolve with given context and args
- // (i is used internally)
- fire: function( context , args , i ) {
+ fire: function( context , args ) {
if ( ! cancelled && ! fired && ! firing ) {
+
firing = 1;
+
try {
- for( i = 0 ; ! cancelled && callbacks[ i ] ; i++ ) {
- cancelled = ( callbacks[ i ].apply( context , args ) === false ) && cancellable;
+ while( callbacks[ 0 ] ) {
+ callbacks.shift().apply( context , args );
}
- } catch( e ) {
- cancelled = cancellable;
- jQuery.error( e );
- } finally {
+ }
+ finally {
fired = [ context , args ];
- callbacks = cancelled ? [] : callbacks.slice( i + 1 );
firing = 0;
}
}
return this;
},
- // cancelling further callbacks
+ // Has this deferred been resolved?
+ isResolved: function() {
+ return !!( firing || fired );
+ },
+
+ // Cancel
cancel: function() {
- if ( cancellable ) {
- callbacks = [];
- cancelled = 1;
- }
+ cancelled = 1;
+ callbacks = [];
return this;
- }
+ },
+ // Has this deferred been cancelled?
+ isCancelled: function() {
+ return !!cancelled;
+ }
};
- // Add the deferred marker
- deferred.then._ = deferredMarker;
-
return deferred;
},
// Full fledged deferred (two callbacks list)
// Typical success/error system
- deferred: function( func , cancellable ) {
-
- // Handle varargs
- if ( arguments.length === 1 ) {
-
- if ( typeof func === "boolean" ) {
- cancellable = func;
- func = 0;
- }
- }
+ Deferred: function( func ) {
- var errorDeferred = jQuery._deferred( cancellable ),
- deferred = jQuery._deferred( cancellable ),
- // Keep reference of the cancel method since we'll redefine it
- cancelThen = deferred.cancel;
+ var errorDeferred = jQuery._Deferred(),
+ deferred = jQuery._Deferred(),
+ successCancel = deferred.cancel;
// Add errorDeferred methods and redefine cancel
jQuery.extend( deferred , {
fail: errorDeferred.then,
fireReject: errorDeferred.fire,
reject: errorDeferred.resolve,
- cancel: function() {
- cancelThen();
- errorDeferred.cancel();
- return this;
+ 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;
}
} );
+ // Remove cancel related
+ delete deferred.cancel;
+ delete deferred.isCancelled;
+
+ // Add promise marker
+ deferred.promise._ = promiseMarker;
+
// Make sure only one callback list will be used
- deferred.then( errorDeferred.cancel ).fail( cancelThen );
+ deferred.then( errorDeferred.cancel ).fail( successCancel );
// Call given func if any
if ( func ) {
return deferred;
},
- // Check if an object is a deferred
- isDeferred: function( object , method ) {
- method = method || "then";
- return !!( object && object[ method ] && object[ method ]._ === deferredMarker );
- },
-
// Deferred helper
- when: function( object , method ) {
- method = method || "then";
- object = jQuery.isDeferred( object , method ) ?
+ when: function( object ) {
+ object = object && object.promise && object.promise._ === promiseMarker ?
object :
- jQuery.deferred().resolve( object );
- object.fail = object.fail || function() { return this; };
- object[ method ] = object[ method ] || object.then;
- object.then = object.then || object[ method ];
- return object;
+ jQuery.Deferred().resolve( object );
+ return object.promise();
},
// Use of jQuery.browser is frowned upon.
});
// Create readyList deferred
-// also force $.fn.ready to be recognized as a defer
-readyList = jQuery._deferred( false );
-jQuery.fn.ready._ = deferredMarker;
+readyList = jQuery._Deferred();
// Populate the class2type map
jQuery.each("Boolean Number String Function Array Date RegExp Object".split(" "), function(i, name) {