X-Git-Url: http://git.asbjorn.biz/?a=blobdiff_plain;f=src%2Fajax.js;h=871481d01ab832b319a2ea4ce8e54f84f6b86213;hb=158fa822dea3198de5a4bcff3955b869ebb758c8;hp=86709005e0a0b7ce720d204acf34c9b140bb4176;hpb=eed3803c98bf5c074e40aad12f2e91435bf81154;p=jquery.git diff --git a/src/ajax.js b/src/ajax.js index 8670900..871481d 100644 --- a/src/ajax.js +++ b/src/ajax.js @@ -1,5 +1,5 @@ (function( jQuery ) { - + var r20 = /%20/g, rbracket = /\[\]$/, rhash = /#.*$/, @@ -10,11 +10,12 @@ var r20 = /%20/g, rscript = /)<[^<]*)*<\/script>/gi, rselectTextarea = /^(?:select|textarea)/i, rts = /([?&])_=[^&]*/, - rurl = /^(\w+:)?\/\/([^\/?#]+)/, + rurl = /^(\w+:)?\/\/([^\/?#:]+)(?::(\d+))?/, + rCRLF = /\r?\n/g, // Slice function sliceFunc = Array.prototype.slice, - + // Keep a copy of the old load method _load = jQuery.fn.load; @@ -60,26 +61,34 @@ jQuery.fn.extend({ type: type, dataType: "html", data: params, - complete: function( res, status ) { + // Complete callback (responseText is used internally) + complete: function( jXHR, status, responseText ) { + // Store the response as specified by the jXHR object + responseText = jXHR.responseText; // If successful, inject the HTML into all the matched elements - if ( status === "success" || status === "notmodified" ) { + if ( jXHR.isResolved() ) { + // #4825: Get the actual response in case + // a dataFilter is present in ajaxSettings + jXHR.done(function( r ) { + responseText = r; + }); // See if a selector was specified self.html( selector ? // Create a dummy div to hold the results jQuery("
") // inject the contents of the document in, removing the scripts // to avoid any 'Permission Denied' errors in IE - .append(res.responseText.replace(rscript, "")) + .append(responseText.replace(rscript, "")) // Locate the specified elements .find(selector) : // If not, just inject the full result - res.responseText ); + responseText ); } if ( callback ) { - self.each( callback, [res.responseText, status, res] ); + self.each( callback, [responseText, status, jXHR] ); } } }); @@ -107,9 +116,9 @@ jQuery.fn.extend({ null : jQuery.isArray(val) ? jQuery.map( val, function(val, i){ - return {name: elem.name, value: val.replace(/\r?\n/g, "\r\n")}; + return { name: elem.name, value: val.replace(rCRLF, "\r\n") }; }) : - {name: elem.name, value: val.replace(/\r?\n/g, "\r\n")}; + { name: elem.name, value: val.replace(rCRLF, "\r\n") }; }).get(); } }); @@ -151,7 +160,8 @@ jQuery.extend({ }, ajaxSetup: function( settings ) { - jQuery.extend( jQuery.ajaxSettings, settings ); + jQuery.extend( true, jQuery.ajaxSettings, settings ); + return this; }, ajaxSettings: { @@ -165,11 +175,12 @@ jQuery.extend({ timeout: 0, data: null, dataType: null, - dataTypes: null, username: null, password: null, cache: null, traditional: false, + headers: {}, + crossDomain: null, */ xhr: function() { return new window.XMLHttpRequest(); @@ -227,26 +238,26 @@ jQuery.extend({ // Main method // (s is used internally) ajax: function( url , options , s ) { - + // Handle varargs if ( arguments.length === 1 ) { options = url; url = options ? options.url : undefined; } - + // Force options to be an object options = options || {}; - + // Get the url if provided separately options.url = url || options.url; - + // Create the final options object s = jQuery.extend( true , {} , jQuery.ajaxSettings , options ); - + // We force the original context // (plain objects used as context get extended) s.context = options.context; - + var // jQuery lists jQuery_lastModified = jQuery.lastModified, jQuery_etag = jQuery.etag, @@ -256,6 +267,8 @@ jQuery.extend({ // Deferreds deferred = jQuery.Deferred(), completeDeferred = jQuery._Deferred(), + // Status-dependent callbacks + statusCode = s.statusCode || {}, // Headers (they are sent all at once) requestHeaders = {}, // Response headers @@ -265,15 +278,18 @@ jQuery.extend({ transport, // timeout handle timeoutTimer, + // Cross-domain detection vars + loc = document.location, + parts, // The jXHR state state = 0, // Loop variable i, // Fake xhr jXHR = { - + readyState: 0, - + // Caches the header setRequestHeader: function(name,value) { if ( state === 0 ) { @@ -281,40 +297,45 @@ jQuery.extend({ } return this; }, - + // Raw string getAllResponseHeaders: function() { return state === 2 ? responseHeadersString : null; }, - + // Builds headers hashtable if needed // (match is used internally) getResponseHeader: function( key , match ) { - - if ( state !== 2 ) { - return null; - } - - if ( responseHeaders === undefined ) { - - responseHeaders = {}; - - if ( typeof responseHeadersString === "string" ) { - - while( ( match = rheaders.exec( responseHeadersString ) ) ) { - responseHeaders[ match[ 1 ].toLowerCase() ] = match[ 2 ]; + + if ( state === 2 ) { + + if ( responseHeaders === undefined ) { + + responseHeaders = {}; + + if ( typeof responseHeadersString === "string" ) { + + while( ( match = rheaders.exec( responseHeadersString ) ) ) { + responseHeaders[ match[ 1 ].toLowerCase() ] = match[ 2 ]; + } } } + match = responseHeaders[ key.toLowerCase() ]; + + } else { + + match = null; } - return responseHeaders[ key.toLowerCase() ]; + + return match; }, - + // Cancel the request abort: function( statusText ) { - if ( transport && state !== 2 ) { + if ( transport ) { transport.abort( statusText || "abort" ); - done( 0 , statusText ); } + done( 0 , statusText ); return this; } }; @@ -323,15 +344,19 @@ jQuery.extend({ // It is defined here because jslint complains if it is declared // at the end of the function (which would be more logical and readable) function done( status , statusText , response , headers) { - + // Called once if ( state === 2 ) { return; } - + // State is "done" now state = 2; - + + // Dereference transport for early garbage collection + // (no matter how long the jXHR transport will be used + transport = 0; + // Set readyState jXHR.readyState = status ? 4 : 0; @@ -342,35 +367,28 @@ jQuery.extend({ if ( timeoutTimer ) { clearTimeout(timeoutTimer); } - + var // Reference url url = s.url, // and ifModified status ifModified = s.ifModified, - + // Is it a success? isSuccess = 0, // Stored success success, // Stored error - error = statusText; - - // If not timeout, force a jQuery-compliant status text - if ( statusText != "timeout" ) { - statusText = ( status >= 200 && status < 300 ) ? - "success" : - ( status === 304 ? "notmodified" : "error" ); - } - + error; + // If successful, handle type chaining - if ( statusText === "success" || statusText === "notmodified" ) { - + if ( status >= 200 && status < 300 || status === 304 ) { + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. if ( s.ifModified ) { - + var lastModified = jXHR.getResponseHeader("Last-Modified"), etag = jXHR.getResponseHeader("Etag"); - + if (lastModified) { jQuery_lastModified[ s.url ] = lastModified; } @@ -378,113 +396,154 @@ jQuery.extend({ jQuery_etag[ s.url ] = etag; } } - - if ( s.ifModified && statusText === "notmodified" ) { - - success = null; + + // If not modified + if ( status === 304 ) { + + // Set the statusText accordingly + statusText = "notmodified"; + // Mark as a success isSuccess = 1; - + + // If we have data } else { + + // Set the statusText accordingly + statusText = "success"; + // Chain data conversions and determine the final value // (if an exception is thrown in the process, it'll be notified as an error) try { - + var i, + // Current dataType current, + // Previous dataType prev, - checker, + // Conversion function conv, + // Conversion functions (when text is used in-between) conv1, conv2, - convertion, + // Local references to dataTypes & converters dataTypes = s.dataTypes, converters = s.converters, + // DataType to responseXXX field mapping responses = { "xml": "XML", "text": "Text" }; - + + // For each dataType in the chain for( i = 0 ; i < dataTypes.length ; i++ ) { - + current = dataTypes[ i ]; - + + // If a responseXXX field for this dataType exists + // and if it hasn't been set yet if ( responses[ current ] ) { + // Set it jXHR[ "response" + responses[ current ] ] = response; + // Mark it as set responses[ current ] = 0; } - + + // If this is not the first element if ( i ) { - + + // Get the dataType to convert from prev = dataTypes[ i - 1 ]; - + + // If no catch-all and dataTypes are actually different if ( prev !== "*" && current !== "*" && prev !== current ) { - - conv = converters[ ( conversion = prev + " " + current ) ] || + + // Get the converter + conv = converters[ prev + " " + current ] || converters[ "* " + current ]; - + conv1 = conv2 = 0; - + + // If there is no direct converter and none of the dataTypes is text if ( ! conv && prev !== "text" && current !== "text" ) { + // Try with text in-between conv1 = converters[ prev + " text" ] || converters[ "* text" ]; conv2 = converters[ "text " + current ]; + // Revert back to a single converter + // if one of the converter is an equivalence if ( conv1 === true ) { conv = conv2; } else if ( conv2 === true ) { conv = conv1; } } - + // If we found no converter, dispatch an error if ( ! ( conv || conv1 && conv2 ) ) { throw conversion; } - + // If found converter is not an equivalence if ( conv !== true ) { + // Convert with 1 or 2 converters accordingly response = conv ? conv( response ) : conv2( conv1( response ) ); } } + // If it is the first element of the chain + // and we have a dataFilter } else if ( s.dataFilter ) { - - response = s.dataFilter( response ); + // Apply the dataFilter + response = s.dataFilter( response , current ); + // Get dataTypes again in case the filter changed them dataTypes = s.dataTypes; } } - + // End of loop + // We have a real success success = response; isSuccess = 1; - + + // If an exception was thrown } catch(e) { - + + // We have a parsererror statusText = "parsererror"; error = "" + e; - + } } - - } else { // if not success, mark it as an error - - error = error || statusText; + + // if not success, mark it as an error + } else { + + error = statusText = statusText || "error"; + + // Set responseText if needed + if ( response ) { + jXHR.responseText = response; + } } - + // Set data for the fake xhr object jXHR.status = status; jXHR.statusText = statusText; - + // Success/Error if ( isSuccess ) { deferred.fire( callbackContext , [ success , statusText , jXHR ] ); } else { deferred.fireReject( callbackContext , [ jXHR , statusText , error ] ); } - + + // Status-dependent callbacks + jXHR.statusCode( statusCode ); + if ( s.global ) { globalEventContext.trigger( "ajax" + ( isSuccess ? "Success" : "Error" ) , [ jXHR , s , isSuccess ? success : error ] ); } - + // Complete completeDeferred.fire( callbackContext, [ jXHR , statusText ] ); - + if ( s.global ) { globalEventContext.trigger( "ajaxComplete" , [ jXHR , s] ); // Handle the global AJAX counter @@ -493,126 +552,157 @@ jQuery.extend({ } } } - + // Attach deferreds deferred.promise( jXHR ); - jXHR.success = jXHR.then; + jXHR.success = jXHR.done; jXHR.error = jXHR.fail; - jXHR.complete = completeDeferred.then; + jXHR.complete = completeDeferred.done; + + // Status-dependent callbacks + jXHR.statusCode = function( map ) { + if ( map ) { + var resolved = jXHR.isResolved(), + tmp; + if ( resolved || jXHR.isRejected() ) { + tmp = map[ jXHR.status ]; + if ( tmp ) { + if ( map === statusCode ) { + delete statusCode[ jXHR.status ]; + } + jXHR[ resolved ? "done" : "fail" ]( tmp ); + } + } else { + for( tmp in map ) { + statusCode[ tmp ] = [ statusCode[ tmp ] , map[ tmp ] ]; + } + } + } + return this; + }; // Remove hash character (#7531: and string promotion) s.url = ( "" + s.url ).replace( rhash , "" ); - - // Uppercase the type - s.type = s.type.toUpperCase(); - - // Determine if request has content - s.hasContent = ! rnoContent.test( s.type ); - + // Extract dataTypes list s.dataTypes = jQuery.trim( s.dataType || "*" ).toLowerCase().split( /\s+/ ); - + // Determine if a cross-domain request is in order - var parts = rurl.exec( s.url.toLowerCase() ), - loc = location; - s.crossDomain = !!( parts && ( parts[ 1 ] && parts[ 1 ] != loc.protocol || parts[ 2 ] != loc.host ) ); + if ( ! s.crossDomain ) { + parts = rurl.exec( s.url.toLowerCase() ); + s.crossDomain = !!( + parts && + ( parts[ 1 ] && parts[ 1 ] != loc.protocol || + parts[ 2 ] != loc.hostname || + ( parts[ 3 ] || 80 ) != ( loc.port || 80 ) ) + ); + } // Convert data if not already a string - if ( s.data && s.processData && typeof s.data != "string" ) { + if ( s.data && s.processData && typeof s.data !== "string" ) { s.data = jQuery.param( s.data , s.traditional ); } + // Apply prefilters + jQuery.ajaxPrefilter( s , options ); + + // Uppercase the type + s.type = s.type.toUpperCase(); + + // Determine if request has content + s.hasContent = ! rnoContent.test( s.type ); + // Watch for a new set of requests if ( s.global && jQuery.active++ === 0 ) { jQuery.event.trigger( "ajaxStart" ); } - - // Get transport - transport = jQuery.ajax.prefilter( s ).transport( s ); - - // If no transport, we auto-abort - if ( ! transport ) { - - done( 0 , "transport not found" ); - jXHR = false; - - } else { - - // More options handling for requests with no content - if ( ! s.hasContent ) { - - // If data is available, append data to url - if ( s.data ) { - s.url += ( rquery.test( s.url ) ? "&" : "?" ) + s.data; - } - - // Add anti-cache in url if needed - if ( s.cache === false ) { - - var ts = jQuery.now(), - // try replacing _= if it is there - ret = s.url.replace( rts , "$1_=" + ts ); - - // if nothing was replaced, add timestamp to the end - s.url = ret + ( (ret == s.url ) ? ( rquery.test( s.url ) ? "&" : "?" ) + "_=" + ts : ""); - } + + // More options handling for requests with no content + if ( ! s.hasContent ) { + + // If data is available, append data to url + if ( s.data ) { + s.url += ( rquery.test( s.url ) ? "&" : "?" ) + s.data; } - - // Set the correct header, if data is being sent - if ( ( s.data && s.hasContent ) || options.contentType ) { - requestHeaders[ "content-type" ] = s.contentType; + + // Add anti-cache in url if needed + if ( s.cache === false ) { + + var ts = jQuery.now(), + // try replacing _= if it is there + ret = s.url.replace( rts , "$1_=" + ts ); + + // if nothing was replaced, add timestamp to the end + s.url = ret + ( (ret == s.url ) ? ( rquery.test( s.url ) ? "&" : "?" ) + "_=" + ts : ""); } - - // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. - if ( s.ifModified ) { - if ( jQuery_lastModified[ s.url ] ) { - requestHeaders[ "if-modified-since" ] = jQuery_lastModified[ s.url ]; - } - if ( jQuery_etag[ s.url ] ) { - requestHeaders[ "if-none-match" ] = jQuery_etag[ s.url ]; - } + } + + // Set the correct header, if data is being sent + if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { + requestHeaders[ "content-type" ] = s.contentType; + } + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + if ( jQuery_lastModified[ s.url ] ) { + requestHeaders[ "if-modified-since" ] = jQuery_lastModified[ s.url ]; + } + if ( jQuery_etag[ s.url ] ) { + requestHeaders[ "if-none-match" ] = jQuery_etag[ s.url ]; } - - // Set the Accepts header for the server, depending on the dataType - requestHeaders.accept = s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? - s.accepts[ s.dataTypes[ 0 ] ] + ( s.dataTypes[ 0 ] !== "*" ? ", */*; q=0.01" : "" ) : - s.accepts[ "*" ]; - - // Check for headers option - for ( i in s.headers ) { - requestHeaders[ i.toLowerCase() ] = s.headers[ i ]; + } + + // Set the Accepts header for the server, depending on the dataType + requestHeaders.accept = s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? + s.accepts[ s.dataTypes[ 0 ] ] + ( s.dataTypes[ 0 ] !== "*" ? ", */*; q=0.01" : "" ) : + s.accepts[ "*" ]; + + // Check for headers option + for ( i in s.headers ) { + requestHeaders[ i.toLowerCase() ] = s.headers[ i ]; + } + + // Allow custom headers/mimetypes and early abort + if ( s.beforeSend && ( s.beforeSend.call( callbackContext , jXHR , s ) === false || state === 2 ) ) { + + // Abort if not done already + done( 0 , "abort" ); + + // Return false + jXHR = false; + + } else { + + // Install callbacks on deferreds + for ( i in { success:1, error:1, complete:1 } ) { + jXHR[ i ]( s[ i ] ); } - - // Allow custom headers/mimetypes and early abort - if ( s.beforeSend && ( s.beforeSend.call( callbackContext , jXHR , s ) === false || state === 2 ) ) { - - // Abort if not done already - done( 0 , "abort" ); - jXHR = false; - + + // Get transport + transport = jQuery.ajaxTransport( s ); + + // If no transport, we auto-abort + if ( ! transport ) { + + done( 0 , "notransport" ); + } else { - + // Set state as sending - state = 1; - jXHR.readyState = 1; - - // Install callbacks on deferreds - for ( i in { success:1, error:1, complete:1 } ) { - jXHR[ i ]( s[ i ] ); - } - + state = jXHR.readyState = 1; + // Send global event if ( s.global ) { globalEventContext.trigger( "ajaxSend" , [ jXHR , s ] ); } - + // Timeout if ( s.async && s.timeout > 0 ) { timeoutTimer = setTimeout(function(){ jXHR.abort( "timeout" ); }, s.timeout); } - + // Try to send try { transport.send(requestHeaders, done); @@ -622,7 +712,7 @@ jQuery.extend({ done(0, "error", "" + e); jXHR = false; - + // Simply rethrow otherwise } else { jQuery.error(e); @@ -630,7 +720,7 @@ jQuery.extend({ } } } - + return jXHR; }, @@ -733,13 +823,13 @@ function ajax_selectOrExecute( structure , s ) { checked = {}, flag, noSelect = structure !== "transports"; - + function initSearch( dataType ) { flag = transportDataType !== dataType && ! checked[ dataType ]; - + if ( flag ) { - + checked[ dataType ] = 1; transportDataType = dataType; list = s[ structure ][ dataType ]; @@ -749,15 +839,15 @@ function ajax_selectOrExecute( structure , s ) { return flag; } - + initSearch( dataTypes[ 0 ] ); for ( i = 0 ; ( noSelect || ! selected ) && i <= length ; i++ ) { - + if ( i === length ) { - + initSearch( "*" ); - + } else { selected = list[ i ]( s , determineDataType ); @@ -773,12 +863,12 @@ function ajax_selectOrExecute( structure , s ) { } } - return noSelect ? jQuery.ajax : selected; + return noSelect ? jQuery : selected; } // Add an element to one of the structures in ajaxSettings function ajax_addElement( structure , args ) { - + var i, start = 0, length = args.length, @@ -789,41 +879,41 @@ function ajax_addElement( structure , args ) { first, append, list; - + if ( length ) { - + first = jQuery.type( args[ 0 ] ); - + if ( first === "object" ) { return ajax_selectOrExecute( structure , args[ 0 ] ); } - + structure = jQuery.ajaxSettings[ structure ]; - + if ( first !== "function" ) { - + dataTypes = args[ 0 ].toLowerCase().split(/\s+/); dLength = dataTypes.length; start = 1; - + } - + if ( dLength && start < length ) { - + functors = sliceFunc.call( args , start ); - + for( i = 0 ; i < dLength ; i++ ) { - + dataType = dataTypes[ i ]; - + first = /^\+/.test( dataType ); - + if (first) { dataType = dataType.substr(1); } - + if ( dataType !== "" ) { - + append = Array.prototype[ first ? "unshift" : "push" ]; list = structure[ dataType ] = structure[ dataType ] || []; append.apply( list , functors ); @@ -831,29 +921,29 @@ function ajax_addElement( structure , args ) { } } } - - return jQuery.ajax; + + return jQuery; } // Install prefilter & transport methods -jQuery.each( [ "prefilter" , "transport" ] , function( _ , name ) { - _ = name + "s"; - jQuery.ajax[ name ] = function() { +jQuery.each( [ "Prefilter" , "Transport" ] , function( _ , name ) { + _ = name.toLowerCase() + "s"; + jQuery[ "ajax" + name ] = function() { return ajax_addElement( _ , arguments ); }; } ); - + // Utility function that handles dataType when response is received // (for those transports that can give text or xml responses) function determineDataType( s , ct , text , xml ) { - + var contents = s.contents, type, regexp, dataTypes = s.dataTypes, transportDataType = dataTypes[0], response; - + // Auto (xml, json, script or text determined given headers) if ( transportDataType === "*" ) { @@ -862,30 +952,30 @@ function determineDataType( s , ct , text , xml ) { transportDataType = dataTypes[0] = type; break; } - } - } - + } + } + // xml and parsed as such if ( transportDataType === "xml" && xml && xml.documentElement /* #4958 */ ) { - + response = xml; - + // Text response was provided } else { - + response = text; - + // If it's not really text, defer to converters if ( transportDataType !== "text" ) { dataTypes.unshift( "text" ); } - + } - + return response; -} +} /* * Create the request object; Microsoft failed to properly