Fixes #8177. XHR transport now considers 304 Not Modified responses as 200 OK if...
[jquery.git] / src / ajax / xhr.js
index 4acb700..b18274c 100644 (file)
@@ -1,5 +1,18 @@
 (function( jQuery ) {
 
+// Functions to create xhrs
+function createStandardXHR() {
+       try {
+               return new window.XMLHttpRequest();
+       } catch( e ) {}
+}
+
+function createActiveXHR() {
+       try {
+               return new window.ActiveXObject("Microsoft.XMLHTTP");
+       } catch( e ) {}
+}
+
 var // Next active xhr id
        xhrId = jQuery.now(),
 
@@ -12,8 +25,8 @@ var // Next active xhr id
        // XHR used to determine supports properties
        testXHR;
 
-// Create the request object; Microsoft failed to properly
-// (This is still attached to ajaxSettings for backward compatibility reasons)
+// Create the request object
+// (This is still attached to ajaxSettings for backward compatibility)
 jQuery.ajaxSettings.xhr = window.ActiveXObject ?
        /* Microsoft failed to properly
         * implement the XMLHttpRequest in IE7 (can't request local files),
@@ -22,190 +35,194 @@ jQuery.ajaxSettings.xhr = window.ActiveXObject ?
         * we need a fallback.
         */
        function() {
-               if ( window.location.protocol !== "file:" ) {
-                       try {
-                               return new window.XMLHttpRequest();
-                       } catch( xhrError ) {}
-               }
-
-               try {
-                       return new window.ActiveXObject("Microsoft.XMLHTTP");
-               } catch( activeError ) {}
+               return !this.isLocal && createStandardXHR() || createActiveXHR();
        } :
        // For all other browsers, use the standard XMLHttpRequest object
-       function() {
-               return new window.XMLHttpRequest();
-       };
+       createStandardXHR;
 
 // Test if we can create an xhr object
-try {
-       testXHR = jQuery.ajaxSettings.xhr();
-} catch( xhrCreationException ) {}
-
-//Does this browser support XHR requests?
+testXHR = jQuery.ajaxSettings.xhr();
 jQuery.support.ajax = !!testXHR;
 
 // Does this browser support crossDomain XHR requests
-jQuery.support.cors = testXHR && "withCredentials" in testXHR;
+jQuery.support.cors = testXHR && ( "withCredentials" in testXHR );
 
 // No need for the temporary xhr anymore
 testXHR = undefined;
 
 // Create transport if the browser can provide an xhr
 if ( jQuery.support.ajax ) {
-       jQuery.ajaxTransport( function( s ) {
 
+       jQuery.ajaxTransport(function( s ) {
                // Cross domain only allowed if supported through XMLHttpRequest
-               if ( ! s.crossDomain || jQuery.support.cors ) {
+               if ( !s.crossDomain || jQuery.support.cors ) {
 
                        var callback;
 
                        return {
-
-                               send: function(headers, complete) {
+                               send: function( headers, complete ) {
 
                                        // #5280: we need to abort on unload or IE will keep connections alive
-                                       if ( ! xhrUnloadAbortInstalled ) {
+                                       if ( !xhrUnloadAbortInstalled ) {
 
                                                xhrUnloadAbortInstalled = 1;
 
-                                               jQuery(window).bind( "unload" , function() {
+                                               jQuery(window).bind( "unload", function() {
 
                                                        // Abort all pending requests
-                                                       jQuery.each(xhrs, function(_, xhr) {
+                                                       jQuery.each( xhrs, function( _, xhr ) {
                                                                if ( xhr.onreadystatechange ) {
                                                                        xhr.onreadystatechange( 1 );
                                                                }
-                                                       });
+                                                       } );
 
-                                               });
+                                               } );
                                        }
 
                                        // Get a new xhr
                                        var xhr = s.xhr(),
-                                               handle;
+                                               handle,
+                                               i;
 
                                        // Open the socket
                                        // Passing null username, generates a login popup on Opera (#2865)
                                        if ( s.username ) {
-                                               xhr.open(s.type, s.url, s.async, s.username, s.password);
+                                               xhr.open( s.type, s.url, s.async, s.username, s.password );
                                        } else {
-                                               xhr.open(s.type, s.url, s.async);
+                                               xhr.open( s.type, s.url, s.async );
+                                       }
+
+                                       // Apply custom fields if provided
+                                       if ( s.xhrFields ) {
+                                               for ( i in s.xhrFields ) {
+                                                       xhr[ i ] = s.xhrFields[ i ];
+                                               }
                                        }
 
                                        // Requested-With header
                                        // Not set for crossDomain requests with no content
                                        // (see why at http://trac.dojotoolkit.org/ticket/9486)
                                        // Won't change header if already provided
-                                       if ( ! ( s.crossDomain && ! s.hasContent ) && ! headers["x-requested-with"] ) {
-                                               headers["x-requested-with"] = "XMLHttpRequest";
+                                       if ( !( s.crossDomain && !s.hasContent ) && !headers["x-requested-with"] ) {
+                                               headers[ "x-requested-with" ] = "XMLHttpRequest";
                                        }
 
                                        // Need an extra try/catch for cross domain requests in Firefox 3
                                        try {
-
-                                               jQuery.each(headers, function(key,value) {
-                                                       xhr.setRequestHeader(key,value);
-                                               });
-
-                                       } catch(_) {}
+                                               jQuery.each( headers, function( key, value ) {
+                                                       xhr.setRequestHeader( key, value );
+                                               } );
+                                       } catch( _ ) {}
 
                                        // Do send the request
-                                       try {
-                                               xhr.send( ( s.hasContent && s.data ) || null );
-                                       } catch(e) {
-                                               complete(0, "error", "" + e);
-                                               return;
-                                       }
+                                       // This may raise an exception which is actually
+                                       // handled in jQuery.ajax (so no try/catch here)
+                                       xhr.send( ( s.hasContent && s.data ) || null );
 
                                        // Listener
-                                       callback = function( _ , isAbort ) {
+                                       callback = function( _, isAbort ) {
 
-                                               // Was never called and is aborted or complete
-                                               if ( callback && ( isAbort || xhr.readyState === 4 ) ) {
+                                               var status,
+                                                       statusText,
+                                                       responseHeaders,
+                                                       responses,
+                                                       xml;
 
-                                                       // Only called once
-                                                       callback = 0;
+                                               // Firefox throws exceptions when accessing properties
+                                               // of an xhr when a network error occured
+                                               // http://helpful.knobs-dials.com/index.php/Component_returned_failure_code:_0x80040111_(NS_ERROR_NOT_AVAILABLE)
+                                               try {
 
-                                                       // Do not keep as active anymore
-                                                       // and store back into pool
-                                                       if (handle) {
-                                                               xhr.onreadystatechange = jQuery.noop;
-                                                               delete xhrs[ handle ];
-                                                       }
+                                                       // Was never called and is aborted or complete
+                                                       if ( callback && ( isAbort || xhr.readyState === 4 ) ) {
 
-                                                       // If it's an abort
-                                                       if ( isAbort ) {
+                                                               // Only called once
+                                                               callback = undefined;
 
-                                                               // Abort it manually if needed
-                                                               if ( xhr.readyState !== 4 ) {
-                                                                       xhr.abort();
+                                                               // Do not keep as active anymore
+                                                               if ( handle ) {
+                                                                       xhr.onreadystatechange = jQuery.noop;
+                                                                       delete xhrs[ handle ];
                                                                }
-                                                       } else {
 
-                                                               // Get info
-                                                               var status = xhr.status,
-                                                                       statusText,
-                                                                       response,
+                                                               // If it's an abort
+                                                               if ( isAbort ) {
+                                                                       // Abort it manually if needed
+                                                                       if ( xhr.readyState !== 4 ) {
+                                                                               xhr.abort();
+                                                                       }
+                                                               } else {
+                                                                       // Get info
+                                                                       status = xhr.status;
                                                                        responseHeaders = xhr.getAllResponseHeaders();
-
-                                                               try { // Firefox throws an exception when accessing statusText for faulty cross-domain requests
-
-                                                                       statusText = xhr.statusText;
-
-                                                               } catch( e ) {
-
-                                                                       statusText = ""; // We normalize with Webkit giving an empty statusText
-
+                                                                       responses = {};
+                                                                       xml = xhr.responseXML;
+
+                                                                       // Construct response list
+                                                                       if ( xml && xml.documentElement /* #4958 */ ) {
+                                                                               responses.xml = xml;
+                                                                       }
+                                                                       responses.text = xhr.responseText;
+
+                                                                       // Firefox throws an exception when accessing
+                                                                       // statusText for faulty cross-domain requests
+                                                                       try {
+                                                                               statusText = xhr.statusText;
+                                                                       } catch( e ) {
+                                                                               // We normalize with Webkit giving an empty statusText
+                                                                               statusText = "";
+                                                                       }
+
+                                                                       // Filter status for non standard behaviors
+
+                                                                       // IE - #1450: sometimes returns 1223 when it should be 204
+                                                                       if ( status === 1223 ) {
+                                                                               status = 204;
+                                                                       // Various - #8177: a Not Modified response was received
+                                                                       // yet no conditional request headers was provided
+                                                                       } else if ( status === 304 &&
+                                                                                               !headers[ "if-modified-since" ] &&
+                                                                                               !headers[ "if-none-match" ] ) {
+                                                                               status = 200;
+                                                                       // Status 0 encompasses several cases
+                                                                       } else if ( !status ) {
+                                                                               // Cross-domain
+                                                                               if ( s.crossDomain ) {
+                                                                                       if ( !s.statusText ) {
+                                                                                               // FF, Webkit (other?): There is no status text for errors
+                                                                                               // 302 is the most generic cross-domain status code
+                                                                                               // for errors, could be anything really (even a real 0)
+                                                                                               status = 302;
+                                                                                       }
+                                                                               // All same-domain: for local files, 0 is a success
+                                                                               } else if( s.isLocal ) {
+                                                                                       status = 200;
+                                                                                       // Opera: this notifies success for all requests
+                                                                                       // (verified in 11.01). Patch welcome.
+                                                                               }
+                                                                               // Opera - #6060: sets status as 0 for 304
+                                                                               // Patch welcome.
+                                                                       }
                                                                }
-
-                                                               // Filter status for non standard behaviours
-                                                               // (so many they seem to be the actual "standard")
-                                                               status =
-                                                                       // Opera returns 0 when it should be 304
-                                                                       // Webkit returns 0 for failing cross-domain no matter the real status
-                                                                       status === 0 ?
-                                                                               (
-                                                                                       ! s.crossDomain || statusText ? // Webkit, Firefox: filter out faulty cross-domain requests
-                                                                                       (
-                                                                                               responseHeaders ? // Opera: filter out real aborts #6060
-                                                                                               304
-                                                                                               :
-                                                                                               0
-                                                                                       )
-                                                                                       :
-                                                                                       302 // We assume 302 but could be anything cross-domain related
-                                                                               )
-                                                                               :
-                                                                               (
-                                                                                       status == 1223 ?        // IE sometimes returns 1223 when it should be 204 (see #1450)
-                                                                                               204
-                                                                                               :
-                                                                                               status
-                                                                               );
-
-                                                               // Guess response & update dataType accordingly
-                                                               response =
-                                                                       s.determineDataType(
-                                                                               xhr.getResponseHeader("content-type"),
-                                                                               xhr.responseText,
-                                                                               xhr.responseXML );
-
-                                                               // Call complete
-                                                               complete(status,statusText,response,responseHeaders);
                                                        }
+                                               } catch( firefoxAccessException ) {
+                                                       if ( !isAbort ) {
+                                                               complete( -1, firefoxAccessException );
+                                                       }
+                                               }
+
+                                               // Call complete if needed
+                                               if ( responses ) {
+                                                       complete( status, statusText, responses, responseHeaders );
                                                }
                                        };
 
-                                       // if we're in sync mode
-                                       // or it's in cache and has been retrieved directly (IE6 & IE7)
+                                       // if we're in sync mode or it's in cache
+                                       // and has been retrieved directly (IE6 & IE7)
                                        // we need to manually fire the callback
-                                       if ( ! s.async || xhr.readyState === 4 ) {
-
+                                       if ( !s.async || xhr.readyState === 4 ) {
                                                callback();
-
                                        } else {
-
                                                // Add to list of active xhrs
                                                handle = xhrId++;
                                                xhrs[ handle ] = xhr;