Renamed preprocess to before, for consistency with form plugin
[jquery.git] / src / ajax / ajax.js
index 896f92d..cf6298d 100644 (file)
@@ -33,35 +33,22 @@ jQuery.fn.extend({
         * @desc Same as above, but with an additional parameter
         * and a callback that is executed when the data was loaded.
         *
-        * @test stop();
-        * $('#first').load("data/name.php", function() {
-        *      ok( $('#first').text() == 'ERROR', 'Check if content was injected into the DOM' );
-        *      start();
-        * });
-        *
-        * @test stop(); // check if load can be called with only url
-        * $('#first').load("data/name.php");
-        * $.get("data/name.php", function() {
-        *   ok( $('#first').text() == 'ERROR', 'Check if load works without callback');
-        *   start();
-        * });
-        *
         * @name load
         * @type jQuery
         * @param String url The URL of the HTML file to load.
-        * @param Hash params A set of key/value pairs that will be sent to the server.
-        * @param Function callback A function to be executed whenever the data is loaded.
+        * @param Object params A set of key/value pairs that will be sent as data to the server.
+        * @param Function callback A function to be executed whenever the data is loaded (parameters: responseText, status and reponse itself).
         * @cat AJAX
         */
        load: function( url, params, callback, ifModified ) {
                if ( url.constructor == Function )
                        return this.bind("load", url);
-       
+
                callback = callback || function(){};
-       
+
                // Default to a GET request
                var type = "GET";
-       
+
                // If the second parameter was provided
                if ( params ) {
                        // If it's a function
@@ -69,41 +56,40 @@ jQuery.fn.extend({
                                // We assume that it's the callback
                                callback = params;
                                params = null;
-                               
+
                        // Otherwise, build a param string
                        } else {
                                params = jQuery.param( params );
                                type = "POST";
                        }
                }
-               
+
                var self = this;
-               
+
                // Request the remote document
-               jQuery.ajax( type, url, params,function(res, status){
-                       
-                       if ( status == "success" || !ifModified && status == "notmodified" ) {
-                               // Inject the HTML into all the matched elements
-                               self.html(res.responseText).each( callback, [res.responseText, status] );
-                               
-                               // Execute all the scripts inside of the newly-injected HTML
-                               jQuery("script", self).each(function(){
-                                       if ( this.src )
-                                               jQuery.getScript( this.src );
-                                       else
-                                               eval.call( window, this.text || this.textContent || this.innerHTML || "" );
-                               });
-                       } else
-                               callback.apply( self, [res.responseText, status] );
-       
-               }, ifModified);
-               
+               jQuery.ajax({
+                       url: url,
+                       type: type,
+                       data: params,
+                       ifModified: ifModified,
+                       complete: function(res, status){
+                               if ( status == "success" || !ifModified && status == "notmodified" ) {
+                                       // Inject the HTML into all the matched elements
+                                       self.html(res.responseText)
+                                         // Execute all the scripts inside of the newly-injected HTML
+                                         .evalScripts()
+                                         // Execute callback
+                                         .each( callback, [res.responseText, status, res] );
+                               } else
+                                       callback.apply( self, [res.responseText, status, res] );
+                       }
+               });
                return this;
        },
 
        /**
         * Serializes a set of input elements into a string of data.
-        * This will serialize all given elements. If you need 
+        * This will serialize all given elements. If you need
         * serialization similar to the form submit of a browser,
         * you should use the form plugin. This is also true for
         * selects with multiple attribute set, only a single option
@@ -115,27 +101,40 @@ jQuery.fn.extend({
         * @after name=John&location=Boston
         * @desc Serialize a selection of input elements to a string
         *
-        * @test var data = $(':input').not('button').serialize();
-        * // ignore button, IE takes text content as value, not relevant for this test
-        * ok( data == 'action=Test&text2=Test&radio1=on&radio2=on&check=on&=on&hidden=&foo[bar]=&name=name&=foobar&select1=&select2=3&select3=1', 'Check form serialization as query string' );
-        *
         * @name serialize
         * @type String
         * @cat AJAX
         */
        serialize: function() {
                return jQuery.param( this );
+       },
+
+       /**
+        * Evaluate all script tags inside this jQuery. If they have a src attribute,
+        * the script is loaded, otherwise it's content is evaluated.
+        *
+        * @name evalScripts
+        * @type jQuery
+        * @private
+        * @cat AJAX
+        */
+       evalScripts: function() {
+               return this.find('script').each(function(){
+                       if ( this.src )
+                               // for some weird reason, it doesn't work if the callback is ommited
+                               jQuery.getScript( this.src );
+                       else {
+                               jQuery.globalEval( this.text || this.textContent || this.innerHTML || "" );
+                       }
+               }).end();
        }
-       
+
 });
 
 // If IE is used, create a wrapper for the XMLHttpRequest object
 if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" )
        XMLHttpRequest = function(){
-               return new ActiveXObject(
-                       navigator.userAgent.indexOf("MSIE 5") >= 0 ?
-                       "Microsoft.XMLHTTP" : "Msxml2.XMLHTTP"
-               );
+               return new ActiveXObject("Microsoft.XMLHTTP");
        };
 
 // Attach a bunch of functions for handling common AJAX events
@@ -153,7 +152,7 @@ if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" )
  * @param Function callback The function to execute.
  * @cat AJAX
  */
+
 /**
  * Attach a function to be executed whenever all AJAX requests have ended.
  *
@@ -167,7 +166,7 @@ if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" )
  * @param Function callback The function to execute.
  * @cat AJAX
  */
+
 /**
  * Attach a function to be executed whenever an AJAX request completes.
  *
@@ -181,7 +180,7 @@ if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" )
  * @param Function callback The function to execute.
  * @cat AJAX
  */
+
 /**
  * Attach a function to be executed whenever an AJAX request completes
  * successfully.
@@ -196,7 +195,7 @@ if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" )
  * @param Function callback The function to execute.
  * @cat AJAX
  */
+
 /**
  * Attach a function to be executed whenever an AJAX request fails.
  *
@@ -210,55 +209,10 @@ if ( jQuery.browser.msie && typeof XMLHttpRequest == "undefined" )
  * @param Function callback The function to execute.
  * @cat AJAX
  */
-/**
- * @test stop(); var counter = { complete: 0, success: 0, error: 0 };
- * var success = function() { counter.success++ };
- * var error = function() { counter.error++ };
- * var complete = function() { counter.complete++ };
- * $('#foo').ajaxStart(complete).ajaxStop(complete).ajaxComplete(complete).ajaxError(error).ajaxSuccess(success);
- * // start with successful test
- * $.ajax({url: "data/name.php", success: success, error: error, complete: function() {
- *   ok( counter.error == 0, 'Check succesful request' );
- *   ok( counter.success == 2, 'Check succesful request' );
- *   ok( counter.complete == 3, 'Check succesful request' );
- *   counter.error = 0; counter.success = 0; counter.complete = 0;
- *   $.ajaxTimeout(500);
- *   $.ajax({url: "data/name.php?wait=5", success: success, error: error, complete: function() {
- *     ok( counter.error == 2, 'Check failed request' );
- *     ok( counter.success == 0, 'Check failed request' );
- *     ok( counter.complete == 3, 'Check failed request' );
- *     start();
- *   }});
- * }});
- * @test stop(); var counter = { complete: 0, success: 0, error: 0 };
- * counter.error = 0; counter.success = 0; counter.complete = 0;
- * var success = function() { counter.success++ };
- * var error = function() { counter.error++ };
- * $.ajaxTimeout(0);
- * $.ajax({url: "data/name.php", global: false, success: success, error: error, complete: function() {
- *   ok( counter.error == 0, 'Check sucesful request without globals' );
- *   ok( counter.success == 1, 'Check sucesful request without globals' );
- *   ok( counter.complete == 0, 'Check sucesful request without globals' );
- *   counter.error = 0; counter.success = 0; counter.complete = 0;
- *   $.ajaxTimeout(500);
- *   $.ajax({url: "data/name.php?wait=5", global: false, success: success, error: error, complete: function() {
- *      ok( counter.error == 1, 'Check failed request without globals' );
- *      ok( counter.success == 0, 'Check failed request without globals' );
- *      ok( counter.complete == 0, 'Check failed request without globals' );
- *      start();
- *   }});
- * }});
- * 
- * @name ajaxHandlersTesting
- * @private
- */
 
 new function(){
        var e = "ajaxStart,ajaxStop,ajaxComplete,ajaxError,ajaxSuccess".split(",");
-       
+
        for ( var i = 0; i < e.length; i++ ) new function(){
                var o = e[i];
                jQuery.fn[o] = function(f){
@@ -289,28 +243,29 @@ jQuery.extend({
         * )
         *
         * @name $.get
-        * @type jQuery
+        * @type undefined
         * @param String url The URL of the page to load.
         * @param Hash params A set of key/value pairs that will be sent to the server.
         * @param Function callback A function to be executed whenever the data is loaded.
         * @cat AJAX
         */
        get: function( url, data, callback, type, ifModified ) {
-               if ( data.constructor == Function ) {
-                       type = callback;
+               // shift arguments if data argument was ommited
+               if ( data && data.constructor == Function ) {
                        callback = data;
                        data = null;
                }
-               
-               // append ? + data or & + data, in case there are already params
-               if ( data ) url += ((url.indexOf("?") > -1) ? "&" : "?") + jQuery.param(data);
-               
-               // Build and start the HTTP Request
-               jQuery.ajax( "GET", url, null, function(r, status) {
-                       if ( callback ) callback( jQuery.httpData(r,type), status );
-               }, ifModified);
+
+               // Delegate
+               jQuery.ajax({
+                       url: url,
+                       data: data,
+                       success: callback,
+                       dataType: type,
+                       ifModified: ifModified
+               });
        },
-       
+
        /**
         * Load a remote page using an HTTP GET request, only if it hasn't
         * been modified since it was last retrieved. All of the arguments to
@@ -331,14 +286,8 @@ jQuery.extend({
         *   }
         * )
         *
-        * @test stop();
-        * $.getIfModified("data/name.php", function(msg) {
-        *     ok( msg == 'ERROR', 'Check ifModified' );
-        *     start();
-        * });
-        *
         * @name $.getIfModified
-        * @type jQuery
+        * @type undefined
         * @param String url The URL of the page to load.
         * @param Hash params A set of key/value pairs that will be sent to the server.
         * @param Function callback A function to be executed whenever the data is loaded.
@@ -352,28 +301,30 @@ jQuery.extend({
         * Loads, and executes, a remote JavaScript file using an HTTP GET request.
         * All of the arguments to the method (except URL) are optional.
         *
+        * Warning: Safari <= 2.0.x is unable to evalulate scripts in a global
+        * context sychronously. If you load functions via getScript, make sure
+        * to call them after a delay.
+        *
         * @example $.getScript("test.js")
         *
         * @example $.getScript("test.js", function(){
         *   alert("Script loaded and executed.");
         * })
         *
-        * @test stop();
-        * $.getScript("data/test.js", function() {
-        *      ok( foobar == "bar", 'Check if script was evaluated' );
-        *      start();
-        * });
-        *
         * @name $.getScript
-        * @type jQuery
+        * @type undefined
         * @param String url The URL of the page to load.
         * @param Function callback A function to be executed whenever the data is loaded.
         * @cat AJAX
         */
        getScript: function( url, callback ) {
-               jQuery.get(url, callback, "script");
+               if(callback)
+                       jQuery.get(url, null, callback, "script");
+               else {
+                       jQuery.get(url, null, null, "script");
+               }
        },
-       
+
        /**
         * Load a remote JSON object using an HTTP GET request.
         * All of the arguments to the method (except URL) are optional.
@@ -389,36 +340,17 @@ jQuery.extend({
         *   }
         * )
         *
-        * @test stop();
-        * $.getJSON("data/json.php", {json: "array"}, function(json) {
-        *   ok( json[0].name == 'John', 'Check JSON: first, name' );
-        *   ok( json[0].age == 21, 'Check JSON: first, age' );
-        *   ok( json[1].name == 'Peter', 'Check JSON: second, name' );
-        *   ok( json[1].age == 25, 'Check JSON: second, age' );
-        *   start();
-        * });
-        * @test stop();
-        * $.getJSON("data/json.php", function(json) {
-        *   ok( json.data.lang == 'en', 'Check JSON: lang' );
-        *   ok( json.data.length == 25, 'Check JSON: length' );
-        *   start();
-        * });
-        *
         * @name $.getJSON
-        * @type jQuery
+        * @type undefined
         * @param String url The URL of the page to load.
         * @param Hash params A set of key/value pairs that will be sent to the server.
         * @param Function callback A function to be executed whenever the data is loaded.
         * @cat AJAX
         */
        getJSON: function( url, data, callback ) {
-               if(callback)
-                       jQuery.get(url, data, callback, "json");
-               else {
-                       jQuery.get(url, data, "json");
-               }
+               jQuery.get(url, data, callback, "json");
        },
-       
+
        /**
         * Load a remote page using an HTTP POST request. All of the arguments to
         * the method (except URL) are optional.
@@ -438,29 +370,24 @@ jQuery.extend({
         *   }
         * )
         *
-        * @test stop();
-        * $.post("data/name.php", {xml: "5-2"}, function(xml){
-        *   $('math', xml).each(function() {
-        *          ok( $('calculation', this).text() == '5-2', 'Check for XML' );
-        *          ok( $('result', this).text() == '3', 'Check for XML' );
-        *       });
-        *   start();
-        * });
-        *
         * @name $.post
-        * @type jQuery
+        * @type undefined
         * @param String url The URL of the page to load.
         * @param Hash params A set of key/value pairs that will be sent to the server.
         * @param Function callback A function to be executed whenever the data is loaded.
         * @cat AJAX
         */
        post: function( url, data, callback, type ) {
-               // Build and start the HTTP Request
-               jQuery.ajax( "POST", url, jQuery.param(data), function(r, status) {
-                       if ( callback ) callback( jQuery.httpData(r,type), status );
+               // Delegate
+               jQuery.ajax({
+                       type: "POST",
+                       url: url,
+                       data: data,
+                       success: callback,
+                       dataType: type
                });
        },
-       
+
        // timeout (ms)
        timeout: 0,
 
@@ -472,52 +399,8 @@ jQuery.extend({
         * @example $.ajaxTimeout( 5000 );
         * @desc Make all AJAX requests timeout after 5 seconds.
         *
-        * @test stop();
-        * var passed = 0;
-        * var timeout;
-        * $.ajaxTimeout(1000);
-        * var pass = function() {
-        *      passed++;
-        *      if(passed == 2) {
-        *              ok( true, 'Check local and global callbacks after timeout' );
-        *              clearTimeout(timeout);
-        *      $('#main').unbind("ajaxError");
-        *              start();
-        *      }
-        * };
-        * var fail = function() {
-        *      ok( false, 'Check for timeout failed' );
-        *      start();
-        * };
-        * timeout = setTimeout(fail, 1500);
-        * $('#main').ajaxError(pass);
-        * $.ajax({
-        *   type: "GET",
-        *   url: "data/name.php?wait=5",
-        *   error: pass,
-        *   success: fail
-        * });
-        *
-        * @test stop(); $.ajaxTimeout(50);
-        * $.ajax({
-        *   type: "GET",
-        *   timeout: 5000,
-        *   url: "data/name.php?wait=1",
-        *   error: function() {
-        *         ok( false, 'Check for local timeout failed' );
-        *         start();
-        *   },
-        *   success: function() {
-        *     ok( true, 'Check for local timeout' );
-        *     start();
-        *   }
-        * });
-        * // reset timeout
-        * $.ajaxTimeout(0);
-        * 
-        *
         * @name $.ajaxTimeout
-        * @type jQuery
+        * @type undefined
         * @param Number time How long before an AJAX request times out.
         * @cat AJAX
         */
@@ -527,22 +410,40 @@ jQuery.extend({
 
        // Last-Modified header cache for next request
        lastModified: {},
-       
+
        /**
         * Load a remote page using an HTTP request. This function is the primary
-        * means of making AJAX requests using jQuery. $.ajax() takes one property,
-        * an object of key/value pairs, that're are used to initalize the request.
+        * means of making AJAX requests using jQuery. 
+        *
+        * $.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.
+        *
+        * Please 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.
+        *
+        * Supported datatypes (see dataType option) are:
+        *
+        * "xml": Returns a XML document that can be processed via jQuery.
+        *
+        * "html": Returns HTML as plain text, included script tags are evaluated.
         *
-        * These are all the key/values that can be passed in to 'prop':
+        * "script": Evaluates the response as Javascript and returns it as plain text.
         *
-        * (String) type - The type of request to make (e.g. "POST" or "GET").
+        * "json": Evaluates the response as JSON and returns a Javascript Object
+        *
+        * $.ajax() takes one property, an object of key/value pairs, that are
+        * used to initalize the request. These are all the key/values that can
+        * be passed in to 'prop':
         *
         * (String) url - The URL of the page to request.
-        * 
-        * (String) data - A string of data to be sent to the server (POST only).
+        *
+        * (String) type - The type of request to make (e.g. "POST" or "GET"), default is "GET".
         *
         * (String) dataType - The type of data that you're expecting back from
-        * the server (e.g. "xml", "html", "script", or "json").
+        * the server. No default: If the server sends xml, the responseXML, otherwise
+        * the responseText is is passed to the success callback.
         *
         * (Boolean) ifModified - Allow the request to be successful only if the
         * response has changed since the last request, default is false, ignoring
@@ -550,10 +451,10 @@ jQuery.extend({
         *
         * (Number) timeout - Local timeout to override global timeout, eg. to give a
         * single request a longer timeout while all others timeout after 1 seconds,
-        * see $.ajaxTimeout
+        * see $.ajaxTimeout()
         *
         * (Boolean) global - Wheather to trigger global AJAX event handlers for
-        * this request, default is true. Set to true to prevent that global handlers
+        * this request, default is true. Set to false to prevent that global handlers
         * like ajaxStart or ajaxStop are triggered.
         *
         * (Function) error - A function to be called if the request fails. The
@@ -568,6 +469,24 @@ jQuery.extend({
         * function gets passed two arguments: The XMLHttpRequest object and a
         * string describing the type the success of the request.
         *
+        * (Object|String) data - Data to be sent to the server. Converted to a query
+        * string, if not already a string. Is appended to the url for GET-requests.
+        * Override processData option to prevent processing.
+        *
+        * (String) contentType - When sending data to the server, use this content-type,
+        * default is "application/x-www-form-urlencoded", which is fine for most cases.
+        *
+        * (Boolean) processData - By default, data passed in as an object other as string
+        * will be processed and transformed into a query string, fitting to 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).
+        * If you need synchronous requests, set this option to false.
+        *
+        * (Function) before - A pre-callback to set custom headers etc., the
+        * XMLHttpRequest is passed as the only argument.
+        *
         * @example $.ajax({
         *   type: "GET",
         *   url: "test.js",
@@ -585,85 +504,82 @@ jQuery.extend({
         * });
         * @desc Save some data to the server and notify the user once its complete.
         *
-        * @test stop();
-        * $.ajax({
-        *   type: "GET",
-        *   url: "data/name.php?name=foo",
-        *   success: function(msg){
-        *     ok( msg == 'bar', 'Check for GET' );
-        *     start();
-        *   }
-        * });
-        *
-        * @test stop();
-        * $.ajax({
-        *   type: "POST",
-        *   url: "data/name.php",
-        *   data: "name=peter",
-        *   success: function(msg){
-        *     ok( msg == 'pan', 'Check for POST' );
-        *     start();
-        *   }
-        * });
-        *
         * @name $.ajax
-        * @type jQuery
+        * @type XMLHttpRequest
         * @param Hash prop A set of properties to initialize the request with.
         * @cat AJAX
         */
-       ajax: function( type, url, data, ret, ifModified ) {
-               // If only a single argument was passed in,
-               // assume that it is a object of key/value pairs
-               if ( !url ) {
-                       ret = type.complete;
-                       var success = type.success;
-                       var error = type.error;
-                       var dataType = type.dataType;
-                       var global = typeof type.global == "boolean" ? type.global : true;
-                       var timeout = typeof type.timeout == "number" ? type.timeout : jQuery.timeout;
-                       var ifModified = type.ifModified || false;
-                       data = type.data;
-                       url = type.url;
-                       type = type.type;
+       ajax: function( s ) {
+               // TODO introduce global settings, allowing the client to modify them for all requests, not only timeout
+               s = jQuery.extend({
+                       global: true,
+                       ifModified: false,
+                       type: "GET",
+                       timeout: jQuery.timeout,
+                       complete: null,
+                       success: null,
+                       error: null,
+                       dataType: null,
+                       url: null,
+                       data: null,
+                       contentType: "application/x-www-form-urlencoded",
+                       processData: true,
+                       async: true,
+                       before: null
+               }, s);
+
+               // if data available
+               if ( s.data ) {
+                       // convert data if not already a string
+                       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" )
+                               // "?" + data or "&" + data (in case there are already params)
+                               s.url += ((s.url.indexOf("?") > -1) ? "&" : "?") + s.data;
                }
-               
+
                // Watch for a new set of requests
-               if ( global && ! jQuery.active++ )
+               if ( s.global && ! jQuery.active++ )
                        jQuery.event.trigger( "ajaxStart" );
 
                var requestDone = false;
-       
+
                // Create the request object
                var xml = new XMLHttpRequest();
-       
+
                // Open the socket
-               xml.open(type || "GET", url, true);
-               
+               xml.open(s.type, s.url, s.async);
+
                // Set the correct header, if data is being sent
-               if ( data )
-                       xml.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
-               
+               if ( s.data )
+                       xml.setRequestHeader("Content-Type", s.contentType);
+
                // Set the If-Modified-Since header, if ifModified mode.
-               if ( ifModified )
+               if ( s.ifModified )
                        xml.setRequestHeader("If-Modified-Since",
-                               jQuery.lastModified[url] || "Thu, 01 Jan 1970 00:00:00 GMT" );
-               
+                               jQuery.lastModified[s.url] || "Thu, 01 Jan 1970 00:00:00 GMT" );
+
                // 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.before )
+                       s.before(xml);
+
                // Wait for a response to come back
-               var onreadystatechange = function(istimeout){
+               var onreadystatechange = function(isTimeout){
                        // The transfer is complete and the data is available, or the request timed out
-                       if ( xml && (xml.readyState == 4 || istimeout == "timeout") ) {
+                       if ( xml && (xml.readyState == 4 || isTimeout == "timeout") ) {
                                requestDone = true;
 
-                               var status = jQuery.httpSuccess( xml ) && istimeout != "timeout" ?
-                                       ifModified && jQuery.httpNotModified( xml, url ) ? "notmodified" : "success" : "error";
-                               
+                               var status = jQuery.httpSuccess( xml ) && isTimeout != "timeout" ?
+                                       s.ifModified && jQuery.httpNotModified( xml, s.url ) ? "notmodified" : "success" : "error";
+
                                // Make sure that the request was successful or notmodified
                                if ( status != "error" ) {
                                        // Cache Last-Modified header, if ifModified mode.
@@ -671,49 +587,52 @@ jQuery.extend({
                                        try {
                                                modRes = xml.getResponseHeader("Last-Modified");
                                        } catch(e) {} // swallow exception thrown by FF if header is not available
-                                       
-                                       if ( ifModified && modRes )
-                                               jQuery.lastModified[url] = modRes;
-                                       
-                                       // If a local callback was specified, fire it
-                                       if ( success )
-                                               success( jQuery.httpData( xml, dataType ), status );
-                                       
+
+                                       if ( s.ifModified && modRes )
+                                               jQuery.lastModified[s.url] = modRes;
+
+                                       // process the data (runs the xml through httpData regardless of callback)
+                                       var data = jQuery.httpData( xml, s.dataType );
+
+                                       // If a local callback was specified, fire it and pass it the data
+                                       if ( s.success )
+                                               s.success( data, status );
+
                                        // Fire the global callback
-                                       if( global )
+                                       if( s.global )
                                                jQuery.event.trigger( "ajaxSuccess" );
-                               
+
                                // Otherwise, the request was not successful
                                } else {
                                        // If a local callback was specified, fire it
-                                       if ( error ) error( xml, status );
-                                       
+                                       if ( s.error ) s.error( xml, status );
+
                                        // Fire the global callback
-                                       if( global )
+                                       if( s.global )
                                                jQuery.event.trigger( "ajaxError" );
                                }
-                               
+
                                // The request was completed
-                               if( global )
+                               if( s.global )
                                        jQuery.event.trigger( "ajaxComplete" );
-                               
+
                                // Handle the global AJAX counter
-                               if ( global && ! --jQuery.active )
+                               if ( s.global && ! --jQuery.active )
                                        jQuery.event.trigger( "ajaxStop" );
-       
+
                                // Process result
-                               if ( ret ) ret(xml, status);
-                               
+                               if ( s.complete ) s.complete(xml, status);
+
                                // Stop memory leaks
                                xml.onreadystatechange = function(){};
                                xml = null;
-                               
+
                        }
                };
                xml.onreadystatechange = onreadystatechange;
-               
+
                // Timeout checker
-               if(timeout > 0)
+               if(s.timeout > 0)
                        setTimeout(function(){
                                // Check to see if the request is still happening
                                if (xml) {
@@ -725,15 +644,18 @@ jQuery.extend({
                                        // Clear from memory
                                        xml = null;
                                }
-                       }, timeout);
-               
+                       }, s.timeout);
+
                // Send the data
-               xml.send(data);
+               xml.send(s.data);
+               
+               // return XMLHttpRequest to allow aborting the request etc.
+               return xml;
        },
-       
+
        // Counter for holding the number of active queries
        active: 0,
-       
+
        // Determines if an XMLHttpRequest was successful or not
        httpSuccess: function(r) {
                try {
@@ -757,7 +679,7 @@ jQuery.extend({
 
                return false;
        },
-       
+
        /* Get the data out of an XMLHttpRequest.
         * Return parsed XML if content-type header is "xml" and type is "xml" or omitted,
         * otherwise return plain text.
@@ -769,36 +691,61 @@ jQuery.extend({
                var data = !type && ct && ct.indexOf("xml") >= 0;
                data = type == "xml" || data ? r.responseXML : r.responseText;
 
-               // If the type is "script", eval it
-               if ( type == "script" ) eval.call( window, data );
+               // If the type is "script", eval it in global context
+               if ( type == "script" ) {
+                       jQuery.globalEval( data );
+               }
 
                // Get the JavaScript object, if JSON is used.
                if ( type == "json" ) eval( "data = " + data );
 
+               // evaluate scripts within html
+               if ( type == "html" ) jQuery("<div>").html(data).evalScripts();
+
                return data;
        },
-       
+
        // Serialize an array of form elements or a set of
        // key/values into a query string
        param: function(a) {
                var s = [];
-               
+
                // If an array was passed in, assume that it is an array
                // of form elements
                if ( a.constructor == Array || a.jquery ) {
                        // Serialize the form elements
                        for ( var i = 0; i < a.length; i++ )
                                s.push( a[i].name + "=" + encodeURIComponent( a[i].value ) );
-                       
+
                // Otherwise, assume that it's an object of key/value pairs
                } else {
                        // Serialize the key/values
-                       for ( var j in a )
-                               s.push( j + "=" + encodeURIComponent( a[j] ) );
+                       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( j + "=" + encodeURIComponent( a[j][k] ) );
+                                       }
+                               } else {
+                                       s.push( j + "=" + encodeURIComponent( a[j] ) );
+                               }
+                       }
                }
-               
+
                // Return the resulting serialization
                return s.join("&");
+       },
+       
+       // evalulates a script in global context
+       // not reliable for safari
+       globalEval: function(data) {
+               if (window.execScript)
+                       window.execScript( data );
+               else if(jQuery.browser.safari)
+                       // safari doesn't provide a synchronous global eval
+                       window.setTimeout( data, 0 );
+               else
+                       eval.call( window, data );
        }
 
 });