X-Git-Url: http://git.asbjorn.biz/?a=blobdiff_plain;f=src%2Fajax%2Fajax.js;h=102c7f900b90263a0339624c575f435587dc2025;hb=7c6100f5ed840b49e8e0de1f9eb90ea2ef1c47ef;hp=66519036dace5c8d33059b777f380aaffd31ad00;hpb=ed5bda3020bd418ad8edb477ad2b1fd8b313cc04;p=jquery.git diff --git a/src/ajax/ajax.js b/src/ajax/ajax.js index 6651903..102c7f9 100644 --- a/src/ajax/ajax.js +++ b/src/ajax/ajax.js @@ -55,7 +55,7 @@ jQuery.fn.extend({ // If the second parameter was provided if ( params ) // If it's a function - if ( jQuery.isFunction( params.constructor ) ) { + if ( jQuery.isFunction( params ) ) { // We assume that it's the callback callback = params; params = null; @@ -77,7 +77,7 @@ jQuery.fn.extend({ complete: function(res, status){ if ( status == "success" || !ifModified && status == "notmodified" ) // Inject the HTML into all the matched elements - self.html(res.responseText) + self.attr("innerHTML", res.responseText) // Execute all the scripts inside of the newly-injected HTML .evalScripts() // Execute callback @@ -94,13 +94,14 @@ jQuery.fn.extend({ * This will serialize all given elements. * * A serialization similar to the form submit of a browser is - * provided by the form plugin. It also takes multiple-selects + * provided by the [http://www.malsup.com/jquery/form/ Form Plugin]. + * It also takes multiple-selects * into account, while this method recognizes only a single option. * * @example $("input[@type=text]").serialize(); * @before * - * @after name=John&location=Boston + * @after name=John&location=Boston * @desc Serialize a selection of input elements to a string * * @name serialize @@ -131,12 +132,6 @@ jQuery.fn.extend({ }); -// If IE is used, create a wrapper for the XMLHttpRequest object -if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" ) - XMLHttpRequest = function(){ - return new ActiveXObject("Microsoft.XMLHTTP"); - }; - // Attach a bunch of functions for handling common AJAX events /** @@ -223,7 +218,7 @@ if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" ) */ /** - * Attach a function to be executed before an AJAX request is send. + * Attach a function to be executed before an AJAX request is sent. * * The XMLHttpRequest and settings used for that request are passed * as arguments to the callback. @@ -231,7 +226,7 @@ if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" ) * @example $("#msg").ajaxSend(function(request, settings){ * $(this).append("
  • Starting request at " + settings.url + "
  • "); * }); - * @desc Show a message before an AJAX request is send. + * @desc Show a message before an AJAX request is sent. * * @name ajaxSend * @type jQuery @@ -249,6 +244,13 @@ jQuery.extend({ /** * Load a remote page using an HTTP GET request. * + * This is an easy way to send a simple GET request to a server + * without having to use the more complex $.ajax function. It + * allows a single callback function to be specified that will + * be executed when the request is complete (and only if the response + * has a successful response code). If you need to have both error + * and success callbacks, you may want to use $.ajax. + * * @example $.get("test.cgi"); * * @example $.get("test.cgi", { name: "John", time: "2pm" } ); @@ -268,7 +270,7 @@ jQuery.extend({ * @type XMLHttpRequest * @param String url The URL of the page to load. * @param Map params (optional) Key/value pairs that will be sent to the server. - * @param Function callback (optional) A function to be executed whenever the data is loaded. + * @param Function callback (optional) A function to be executed whenever the data is loaded successfully. * @cat Ajax */ get: function( url, data, callback, type, ifModified ) { @@ -279,6 +281,7 @@ jQuery.extend({ } return jQuery.ajax({ + type: "GET", url: url, data: data, success: callback, @@ -310,7 +313,7 @@ jQuery.extend({ * @type XMLHttpRequest * @param String url The URL of the page to load. * @param Map params (optional) Key/value pairs that will be sent to the server. - * @param Function callback (optional) A function to be executed whenever the data is loaded. + * @param Function callback (optional) A function to be executed whenever the data is loaded successfully. * @cat Ajax */ getIfModified: function( url, data, callback, type ) { @@ -320,7 +323,7 @@ jQuery.extend({ /** * Loads, and executes, a remote JavaScript file using an HTTP GET request. * - * Warning: Safari <= 2.0.x is unable to evalulate scripts in a global + * Warning: Safari <= 2.0.x is unable to evaluate scripts in a global * context synchronously. If you load functions via getScript, make sure * to call them after a delay. * @@ -333,7 +336,7 @@ jQuery.extend({ * @name $.getScript * @type XMLHttpRequest * @param String url The URL of the page to load. - * @param Function callback (optional) A function to be executed whenever the data is loaded. + * @param Function callback (optional) A function to be executed whenever the data is loaded successfully. * @cat Ajax */ getScript: function( url, callback ) { @@ -358,7 +361,7 @@ jQuery.extend({ * @type XMLHttpRequest * @param String url The URL of the page to load. * @param Map params (optional) Key/value pairs that will be sent to the server. - * @param Function callback A function to be executed whenever the data is loaded. + * @param Function callback A function to be executed whenever the data is loaded successfully. * @cat Ajax */ getJSON: function( url, data, callback ) { @@ -387,10 +390,15 @@ jQuery.extend({ * @type XMLHttpRequest * @param String url The URL of the page to load. * @param Map params (optional) Key/value pairs that will be sent to the server. - * @param Function callback (optional) A function to be executed whenever the data is loaded. + * @param Function callback (optional) A function to be executed whenever the data is loaded successfully. * @cat Ajax */ post: function( url, data, callback, type ) { + if ( jQuery.isFunction( data ) ) { + callback = data; + data = {}; + } + return jQuery.ajax({ type: "POST", url: url, @@ -400,11 +408,8 @@ jQuery.extend({ }); }, - // timeout (ms) - //timeout: 0, - /** - * Set the timeout of all AJAX requests to a specific amount of time. + * Set the timeout in milliseconds of all AJAX requests to a specific amount of time. * This will make all future AJAX requests timeout after a specified amount * of time. * @@ -420,7 +425,7 @@ jQuery.extend({ * * @name $.ajaxTimeout * @type undefined - * @param Number time How long before an AJAX request times out. + * @param Number time How long before an AJAX request times out, in milliseconds. * @cat Ajax */ ajaxTimeout: function( timeout ) { @@ -457,7 +462,8 @@ jQuery.extend({ timeout: 0, contentType: "application/x-www-form-urlencoded", processData: true, - async: true + async: true, + data: null }, // Last-Modified header cache for next request @@ -467,15 +473,17 @@ jQuery.extend({ * Load a remote page using an HTTP request. * * This is jQuery's low-level AJAX implementation. See $.get, $.post etc. for - * higher-level abstractions. + * higher-level abstractions that are often easier to understand and use, + * but don't offer as much functionality (such as error callbacks). * * $.ajax() returns the XMLHttpRequest that it creates. In most cases you won't * need that object to manipulate directly, but it is available if you need to * abort the request manually. * - * Note: Make sure the server sends the right mimetype (eg. xml as - * "text/xml"). Sending the wrong mimetype will get you into serious - * trouble that jQuery can't solve. + * '''Note:''' If you specify the dataType option described below, make sure + * the server sends the correct MIME type in the response (eg. xml as "text/xml"). + * Sending the wrong MIME type can lead to unexpected problems in your script. + * See [[Specifying the Data Type for AJAX Requests]] for more information. * * Supported datatypes are (see dataType option): * @@ -503,7 +511,7 @@ jQuery.extend({ * response has changed since the last request. This is done by checking the * Last-Modified header. Default value is false, ignoring the header. * - * (Number) timeout - Local timeout to override global timeout, eg. to give a + * (Number) timeout - Local timeout in milliseconds to override global timeout, eg. to give a * single request a longer timeout while all others timeout after 1 second. * See $.ajaxTimeout() for global timeouts. * @@ -536,7 +544,7 @@ jQuery.extend({ * the default content-type "application/x-www-form-urlencoded". If you want to send * DOMDocuments, set this option to false. * - * (Boolean) async - By default, all requests are send asynchronous (set to true). + * (Boolean) async - By default, all requests are sent asynchronous (set to true). * If you need synchronous requests, set this option to false. * * (Function) beforeSend - A pre-callback to set custom headers etc., the @@ -564,8 +572,8 @@ jQuery.extend({ * async: false * }).responseText; * @desc Loads data synchronously. Blocks the browser while the requests is active. - * It is better to block user interaction with others means when synchronization is - * necessary, instead to block the complete browser. + * It is better to block user interaction by other means when synchronization is + * necessary. * * @example var xmlDocument = [create xml document]; * $.ajax({ @@ -593,9 +601,12 @@ jQuery.extend({ if (s.processData && typeof s.data != "string") s.data = jQuery.param(s.data); // append data to url for get requests - if( s.type.toLowerCase() == "get" ) + if( s.type.toLowerCase() == "get" ) { // "?" + data or "&" + data (in case there are already params) s.url += ((s.url.indexOf("?") > -1) ? "&" : "?") + s.data; + // IE likes to send both get and post data, prevent this + s.data = null; + } } // Watch for a new set of requests @@ -604,8 +615,9 @@ jQuery.extend({ var requestDone = false; - // Create the request object - var xml = new XMLHttpRequest(); + // Create the request object; Microsoft failed to properly + // implement the XMLHttpRequest in IE7, so we use the ActiveXObject when it is available + var xml = window.ActiveXObject ? new ActiveXObject("Microsoft.XMLHTTP") : new XMLHttpRequest(); // Open the socket xml.open(s.type, s.url, s.async); @@ -622,10 +634,6 @@ jQuery.extend({ // Set header so the called script knows that it's an XMLHttpRequest xml.setRequestHeader("X-Requested-With", "XMLHttpRequest"); - // Make sure the browser sends the right content length - if ( xml.overrideMimeType ) - xml.setRequestHeader("Connection", "close"); - // Allow custom headers/mimetypes if( s.beforeSend ) s.beforeSend(xml); @@ -638,6 +646,13 @@ jQuery.extend({ // The transfer is complete and the data is available, or the request timed out if ( xml && (xml.readyState == 4 || isTimeout == "timeout") ) { requestDone = true; + + // clear poll interval + if (ival) { + clearInterval(ival); + ival = null; + } + var status; try { status = jQuery.httpSuccess( xml ) && isTimeout != "timeout" ? @@ -683,11 +698,13 @@ jQuery.extend({ s.complete(xml, status); // Stop memory leaks - xml.onreadystatechange = function(){}; - xml = null; + if(s.async) + xml = null; } }; - xml.onreadystatechange = onreadystatechange; + + // don't attach the handler to the request, just poll it instead + var ival = setInterval(onreadystatechange, 13); // Timeout checker if ( s.timeout > 0 ) @@ -702,12 +719,9 @@ jQuery.extend({ } }, s.timeout); - // save non-leaking reference - var xml2 = xml; - // Send the data try { - xml2.send(s.data); + xml.send(s.data); } catch(e) { jQuery.handleError(s, xml, null, e); } @@ -717,7 +731,7 @@ jQuery.extend({ onreadystatechange(); // return XMLHttpRequest to allow aborting the request etc. - return xml2; + return xml; }, handleError: function( s, xml, status, e ) { @@ -789,17 +803,19 @@ jQuery.extend({ // of form elements if ( a.constructor == Array || a.jquery ) // Serialize the form elements - for ( var i = 0; i < a.length; i++ ) - s.push( encodeURIComponent(a[i].name) + "=" + encodeURIComponent( a[i].value ) ); + jQuery.each( a, function(){ + s.push( encodeURIComponent(this.name) + "=" + encodeURIComponent( this.value ) ); + }); // Otherwise, assume that it's an object of key/value pairs else // Serialize the key/values for ( var j in a ) // If the value is an array then the key names need to be repeated - if ( a[j].constructor == Array ) - for ( var k = 0; k < a[j].length; k++ ) - s.push( encodeURIComponent(j) + "=" + encodeURIComponent( a[j][k] ) ); + if ( a[j] && a[j].constructor == Array ) + jQuery.each( a[j], function(){ + s.push( encodeURIComponent(j) + "=" + encodeURIComponent( this ) ); + }); else s.push( encodeURIComponent(j) + "=" + encodeURIComponent( a[j] ) );