Blame | Letzte Änderung | Log anzeigen | RSS feed
/*!* MockJax - jQuery Plugin to Mock Ajax requests** Version: 1.5.3* Released:* Home: http://github.com/appendto/jquery-mockjax* Author: Jonathan Sharp (http://jdsharp.com)* License: MIT,GPL** Copyright (c) 2011 appendTo LLC.* Dual licensed under the MIT or GPL licenses.* http://appendto.com/open-source-licenses*/(function($) {var _ajax = $.ajax,mockHandlers = [],mockedAjaxCalls = [],CALLBACK_REGEX = /=\?(&|$)/,jsc = (new Date()).getTime();// Parse the given XML string.function parseXML(xml) {if ( window.DOMParser == undefined && window.ActiveXObject ) {DOMParser = function() { };DOMParser.prototype.parseFromString = function( xmlString ) {var doc = new ActiveXObject('Microsoft.XMLDOM');doc.async = 'false';doc.loadXML( xmlString );return doc;};}try {var xmlDoc = ( new DOMParser() ).parseFromString( xml, 'text/xml' );if ( $.isXMLDoc( xmlDoc ) ) {var err = $('parsererror', xmlDoc);if ( err.length == 1 ) {throw('Error: ' + $(xmlDoc).text() );}} else {throw('Unable to parse XML');}return xmlDoc;} catch( e ) {var msg = ( e.name == undefined ? e : e.name + ': ' + e.message );$(document).trigger('xmlParseError', [ msg ]);return undefined;}}// Trigger a jQuery eventfunction trigger(s, type, args) {(s.context ? $(s.context) : $.event).trigger(type, args);}// Check if the data field on the mock handler and the request match. This// can be used to restrict a mock handler to being used only when a certain// set of data is passed to it.function isMockDataEqual( mock, live ) {var identical = true;// Test for situations where the data is a querystring (not an object)if (typeof live === 'string') {// Querystring may be a regexreturn $.isFunction( mock.test ) ? mock.test(live) : mock == live;}$.each(mock, function(k) {if ( live[k] === undefined ) {identical = false;return identical;} else {// This will allow to compare Arraysif ( typeof live[k] === 'object' && live[k] !== null ) {identical = identical && isMockDataEqual(mock[k], live[k]);} else {if ( mock[k] && $.isFunction( mock[k].test ) ) {identical = identical && mock[k].test(live[k]);} else {identical = identical && ( mock[k] == live[k] );}}}});return identical;}// See if a mock handler property matches the default settingsfunction isDefaultSetting(handler, property) {return handler[property] === $.mockjaxSettings[property];}// Check the given handler should mock the given requestfunction getMockForRequest( handler, requestSettings ) {// If the mock was registered with a function, let the function decide if we// want to mock this requestif ( $.isFunction(handler) ) {return handler( requestSettings );}// Inspect the URL of the request and check if the mock handler's url// matches the url for this ajax requestif ( $.isFunction(handler.url.test) ) {// The user provided a regex for the url, test itif ( !handler.url.test( requestSettings.url ) ) {return null;}} else {// Look for a simple wildcard '*' or a direct URL matchvar star = handler.url.indexOf('*');if (handler.url !== requestSettings.url && star === -1 ||!new RegExp(handler.url.replace(/[-[\]{}()+?.,\\^$|#\s]/g, "\\$&").replace(/\*/g, '.+')).test(requestSettings.url)) {return null;}}// Inspect the data submitted in the request (either POST body or GET query string)if ( handler.data && requestSettings.data ) {if ( !isMockDataEqual(handler.data, requestSettings.data) ) {// They're not identical, do not mock this requestreturn null;}}// Inspect the request typeif ( handler && handler.type &&handler.type.toLowerCase() != requestSettings.type.toLowerCase() ) {// The request type doesn't match (GET vs. POST)return null;}return handler;}// Process the xhr objects send operationfunction _xhrSend(mockHandler, requestSettings, origSettings) {// This is a substitute for < 1.4 which lacks $.proxyvar process = (function(that) {return function() {return (function() {var onReady;// The request has returnedthis.status = mockHandler.status;this.statusText = mockHandler.statusText;this.readyState = 4;// We have an executable function, call it to give// the mock handler a chance to update it's dataif ( $.isFunction(mockHandler.response) ) {mockHandler.response(origSettings);}// Copy over our mock to our xhr object before passing control back to// jQuery's onreadystatechange callbackif ( requestSettings.dataType == 'json' && ( typeof mockHandler.responseText == 'object' ) ) {this.responseText = JSON.stringify(mockHandler.responseText);} else if ( requestSettings.dataType == 'xml' ) {if ( typeof mockHandler.responseXML == 'string' ) {this.responseXML = parseXML(mockHandler.responseXML);//in jQuery 1.9.1+, responseXML is processed differently and relies on responseTextthis.responseText = mockHandler.responseXML;} else {this.responseXML = mockHandler.responseXML;}} else {this.responseText = mockHandler.responseText;}if( typeof mockHandler.status == 'number' || typeof mockHandler.status == 'string' ) {this.status = mockHandler.status;}if( typeof mockHandler.statusText === "string") {this.statusText = mockHandler.statusText;}// jQuery 2.0 renamed onreadystatechange to onloadonReady = this.onreadystatechange || this.onload;// jQuery < 1.4 doesn't have onreadystate change for xhrif ( $.isFunction( onReady ) ) {if( mockHandler.isTimeout) {this.status = -1;}onReady.call( this, mockHandler.isTimeout ? 'timeout' : undefined );} else if ( mockHandler.isTimeout ) {// Fix for 1.3.2 timeout to keep success from firing.this.status = -1;}}).apply(that);};})(this);if ( mockHandler.proxy ) {// We're proxying this request and loading in an external file instead_ajax({global: false,url: mockHandler.proxy,type: mockHandler.proxyType,data: mockHandler.data,dataType: requestSettings.dataType === "script" ? "text/plain" : requestSettings.dataType,complete: function(xhr) {mockHandler.responseXML = xhr.responseXML;mockHandler.responseText = xhr.responseText;// Don't override the handler status/statusText if it's specified by the configif (isDefaultSetting(mockHandler, 'status')) {mockHandler.status = xhr.status;}if (isDefaultSetting(mockHandler, 'statusText')) {mockHandler.statusText = xhr.statusText;}this.responseTimer = setTimeout(process, mockHandler.responseTime || 0);}});} else {// type == 'POST' || 'GET' || 'DELETE'if ( requestSettings.async === false ) {// TODO: Blocking delayprocess();} else {this.responseTimer = setTimeout(process, mockHandler.responseTime || 50);}}}// Construct a mocked XHR Objectfunction xhr(mockHandler, requestSettings, origSettings, origHandler) {// Extend with our default mockjax settingsmockHandler = $.extend(true, {}, $.mockjaxSettings, mockHandler);if (typeof mockHandler.headers === 'undefined') {mockHandler.headers = {};}if ( mockHandler.contentType ) {mockHandler.headers['content-type'] = mockHandler.contentType;}return {status: mockHandler.status,statusText: mockHandler.statusText,readyState: 1,open: function() { },send: function() {origHandler.fired = true;_xhrSend.call(this, mockHandler, requestSettings, origSettings);},abort: function() {clearTimeout(this.responseTimer);},setRequestHeader: function(header, value) {mockHandler.headers[header] = value;},getResponseHeader: function(header) {// 'Last-modified', 'Etag', 'content-type' are all checked by jQueryif ( mockHandler.headers && mockHandler.headers[header] ) {// Return arbitrary headersreturn mockHandler.headers[header];} else if ( header.toLowerCase() == 'last-modified' ) {return mockHandler.lastModified || (new Date()).toString();} else if ( header.toLowerCase() == 'etag' ) {return mockHandler.etag || '';} else if ( header.toLowerCase() == 'content-type' ) {return mockHandler.contentType || 'text/plain';}},getAllResponseHeaders: function() {var headers = '';$.each(mockHandler.headers, function(k, v) {headers += k + ': ' + v + "\n";});return headers;}};}// Process a JSONP mock request.function processJsonpMock( requestSettings, mockHandler, origSettings ) {// Handle JSONP Parameter Callbacks, we need to replicate some of the jQuery core here// because there isn't an easy hook for the cross domain script tag of jsonpprocessJsonpUrl( requestSettings );requestSettings.dataType = "json";if(requestSettings.data && CALLBACK_REGEX.test(requestSettings.data) || CALLBACK_REGEX.test(requestSettings.url)) {createJsonpCallback(requestSettings, mockHandler, origSettings);// We need to make sure// that a JSONP style response is executed properlyvar rurl = /^(\w+:)?\/\/([^\/?#]+)/,parts = rurl.exec( requestSettings.url ),remote = parts && (parts[1] && parts[1] !== location.protocol || parts[2] !== location.host);requestSettings.dataType = "script";if(requestSettings.type.toUpperCase() === "GET" && remote ) {var newMockReturn = processJsonpRequest( requestSettings, mockHandler, origSettings );// Check if we are supposed to return a Deferred back to the mock call, or just// signal successif(newMockReturn) {return newMockReturn;} else {return true;}}}return null;}// Append the required callback parameter to the end of the request URL, for a JSONP requestfunction processJsonpUrl( requestSettings ) {if ( requestSettings.type.toUpperCase() === "GET" ) {if ( !CALLBACK_REGEX.test( requestSettings.url ) ) {requestSettings.url += (/\?/.test( requestSettings.url ) ? "&" : "?") +(requestSettings.jsonp || "callback") + "=?";}} else if ( !requestSettings.data || !CALLBACK_REGEX.test(requestSettings.data) ) {requestSettings.data = (requestSettings.data ? requestSettings.data + "&" : "") + (requestSettings.jsonp || "callback") + "=?";}}// Process a JSONP request by evaluating the mocked response textfunction processJsonpRequest( requestSettings, mockHandler, origSettings ) {// Synthesize the mock request for adding a script tagvar callbackContext = origSettings && origSettings.context || requestSettings,newMock = null;// If the response handler on the moock is a function, call itif ( mockHandler.response && $.isFunction(mockHandler.response) ) {mockHandler.response(origSettings);} else {// Evaluate the responseText javascript in a global contextif( typeof mockHandler.responseText === 'object' ) {$.globalEval( '(' + JSON.stringify( mockHandler.responseText ) + ')');} else {$.globalEval( '(' + mockHandler.responseText + ')');}}// Successful responsejsonpSuccess( requestSettings, callbackContext, mockHandler );jsonpComplete( requestSettings, callbackContext, mockHandler );// If we are running under jQuery 1.5+, return a deferred objectif($.Deferred){newMock = new $.Deferred();if(typeof mockHandler.responseText == "object"){newMock.resolveWith( callbackContext, [mockHandler.responseText] );}else{newMock.resolveWith( callbackContext, [$.parseJSON( mockHandler.responseText )] );}}return newMock;}// Create the required JSONP callback function for the requestfunction createJsonpCallback( requestSettings, mockHandler, origSettings ) {var callbackContext = origSettings && origSettings.context || requestSettings;var jsonp = requestSettings.jsonpCallback || ("jsonp" + jsc++);// Replace the =? sequence both in the query string and the dataif ( requestSettings.data ) {requestSettings.data = (requestSettings.data + "").replace(CALLBACK_REGEX, "=" + jsonp + "$1");}requestSettings.url = requestSettings.url.replace(CALLBACK_REGEX, "=" + jsonp + "$1");// Handle JSONP-style loadingwindow[ jsonp ] = window[ jsonp ] || function( tmp ) {data = tmp;jsonpSuccess( requestSettings, callbackContext, mockHandler );jsonpComplete( requestSettings, callbackContext, mockHandler );// Garbage collectwindow[ jsonp ] = undefined;try {delete window[ jsonp ];} catch(e) {}if ( head ) {head.removeChild( script );}};}// The JSONP request was successfulfunction jsonpSuccess(requestSettings, callbackContext, mockHandler) {// If a local callback was specified, fire it and pass it the dataif ( requestSettings.success ) {requestSettings.success.call( callbackContext, mockHandler.responseText || "", status, {} );}// Fire the global callbackif ( requestSettings.global ) {trigger(requestSettings, "ajaxSuccess", [{}, requestSettings] );}}// The JSONP request was completedfunction jsonpComplete(requestSettings, callbackContext) {// Process resultif ( requestSettings.complete ) {requestSettings.complete.call( callbackContext, {} , status );}// The request was completedif ( requestSettings.global ) {trigger( "ajaxComplete", [{}, requestSettings] );}// Handle the global AJAX counterif ( requestSettings.global && ! --$.active ) {$.event.trigger( "ajaxStop" );}}// The core $.ajax replacement.function handleAjax( url, origSettings ) {var mockRequest, requestSettings, mockHandler;// If url is an object, simulate pre-1.5 signatureif ( typeof url === "object" ) {origSettings = url;url = undefined;} else {// work around to support 1.5 signatureorigSettings.url = url;}// Extend the original settings for the requestrequestSettings = $.extend(true, {}, $.ajaxSettings, origSettings);// Iterate over our mock handlers (in registration order) until we find// one that is willing to intercept the requestfor(var k = 0; k < mockHandlers.length; k++) {if ( !mockHandlers[k] ) {continue;}mockHandler = getMockForRequest( mockHandlers[k], requestSettings );if(!mockHandler) {// No valid mock found for this requestcontinue;}mockedAjaxCalls.push(requestSettings);// If logging is enabled, log the mock to the console$.mockjaxSettings.log( mockHandler, requestSettings );if ( requestSettings.dataType === "jsonp" ) {if ((mockRequest = processJsonpMock( requestSettings, mockHandler, origSettings ))) {// This mock will handle the JSONP requestreturn mockRequest;}}// Removed to fix #54 - keep the mocking data object intact//mockHandler.data = requestSettings.data;mockHandler.cache = requestSettings.cache;mockHandler.timeout = requestSettings.timeout;mockHandler.global = requestSettings.global;copyUrlParameters(mockHandler, origSettings);(function(mockHandler, requestSettings, origSettings, origHandler) {mockRequest = _ajax.call($, $.extend(true, {}, origSettings, {// Mock the XHR objectxhr: function() { return xhr( mockHandler, requestSettings, origSettings, origHandler ); }}));})(mockHandler, requestSettings, origSettings, mockHandlers[k]);return mockRequest;}// We don't have a mock requestif($.mockjaxSettings.throwUnmocked === true) {throw('AJAX not mocked: ' + origSettings.url);}else { // trigger a normal requestreturn _ajax.apply($, [origSettings]);}}/*** Copies URL parameter values if they were captured by a regular expression* @param {Object} mockHandler* @param {Object} origSettings*/function copyUrlParameters(mockHandler, origSettings) {//parameters aren't captured if the URL isn't a RegExpif (!(mockHandler.url instanceof RegExp)) {return;}//if no URL params were defined on the handler, don't attempt a captureif (!mockHandler.hasOwnProperty('urlParams')) {return;}var captures = mockHandler.url.exec(origSettings.url);//the whole RegExp match is always the first value in the capture resultsif (captures.length === 1) {return;}captures.shift();//use handler params as keys and capture resuts as valuesvar i = 0,capturesLength = captures.length,paramsLength = mockHandler.urlParams.length,//in case the number of params specified is less than actual capturesmaxIterations = Math.min(capturesLength, paramsLength),paramValues = {};for (i; i < maxIterations; i++) {var key = mockHandler.urlParams[i];paramValues[key] = captures[i];}origSettings.urlParams = paramValues;}// Public$.extend({ajax: handleAjax});$.mockjaxSettings = {//url: null,//type: 'GET',log: function( mockHandler, requestSettings ) {if ( mockHandler.logging === false ||( typeof mockHandler.logging === 'undefined' && $.mockjaxSettings.logging === false ) ) {return;}if ( window.console && console.log ) {var message = 'MOCK ' + requestSettings.type.toUpperCase() + ': ' + requestSettings.url;var request = $.extend({}, requestSettings);if (typeof console.log === 'function') {console.log(message, request);} else {try {console.log( message + ' ' + JSON.stringify(request) );} catch (e) {console.log(message);}}}},logging: true,status: 200,statusText: "OK",responseTime: 500,isTimeout: false,throwUnmocked: false,contentType: 'text/plain',response: '',responseText: '',responseXML: '',proxy: '',proxyType: 'GET',lastModified: null,etag: '',headers: {etag: 'IJF@H#@923uf8023hFO@I#H#','content-type' : 'text/plain'}};$.mockjax = function(settings) {var i = mockHandlers.length;mockHandlers[i] = settings;return i;};$.mockjaxClear = function(i) {if ( arguments.length == 1 ) {mockHandlers[i] = null;} else {mockHandlers = [];}mockedAjaxCalls = [];};$.mockjax.handler = function(i) {if ( arguments.length == 1 ) {return mockHandlers[i];}};$.mockjax.mockedAjaxCalls = function() {return mockedAjaxCalls;};})(jQuery);