X-Git-Url: https://scripts.mit.edu/gitweb/autoinstallsdev/mediawiki.git/blobdiff_plain/19e297c21b10b1b8a3acad5e73fc71dcb35db44a..6932310fd58ebef145fa01eb76edf7150284d8ea:/tests/qunit/data/testrunner.js diff --git a/tests/qunit/data/testrunner.js b/tests/qunit/data/testrunner.js new file mode 100644 index 00000000..e944ef01 --- /dev/null +++ b/tests/qunit/data/testrunner.js @@ -0,0 +1,660 @@ +/* global sinon */ +( function ( $, mw, QUnit ) { + 'use strict'; + + var addons, nested; + + /** + * Make a safe copy of localEnv: + * - Creates a copy so that when the same object reference to module hooks is + * used by multipe test hooks, our QUnit.module extension will not wrap the + * callbacks multiple times. Instead, they wrap using a new object. + * - Normalise setup/teardown to avoid having to repeat this in each extension + * (deprecated in QUnit 1.16, removed in QUnit 2). + * - Strip any other properties. + */ + function makeSafeEnv( localEnv ) { + return { + beforeEach: localEnv.setup || localEnv.beforeEach, + afterEach: localEnv.teardown || localEnv.afterEach + }; + } + + /** + * Add bogus to url to prevent IE crazy caching + * + * @param {string} value a relative path (eg. 'data/foo.js' + * or 'data/test.php?foo=bar'). + * @return {string} Such as 'data/foo.js?131031765087663960' + */ + QUnit.fixurl = function ( value ) { + return value + ( /\?/.test( value ) ? '&' : '?' ) + + String( new Date().getTime() ) + + String( parseInt( Math.random() * 100000, 10 ) ); + }; + + /** + * Configuration + */ + + // For each test() that is asynchronous, allow this time to pass before + // killing the test and assuming timeout failure. + QUnit.config.testTimeout = 60 * 1000; + + // Reduce default animation duration from 400ms to 0ms for unit tests + // eslint-disable-next-line no-underscore-dangle + $.fx.speeds._default = 0; + + // Add a checkbox to QUnit header to toggle MediaWiki ResourceLoader debug mode. + QUnit.config.urlConfig.push( { + id: 'debug', + label: 'Enable ResourceLoaderDebug', + tooltip: 'Enable debug mode in ResourceLoader', + value: 'true' + } ); + + /** + * SinonJS + * + * Glue code for nicer integration with QUnit setup/teardown + * Inspired by http://sinonjs.org/releases/sinon-qunit-1.0.0.js + */ + sinon.assert.fail = function ( msg ) { + QUnit.assert.ok( false, msg ); + }; + sinon.assert.pass = function ( msg ) { + QUnit.assert.ok( true, msg ); + }; + sinon.config = { + injectIntoThis: true, + injectInto: null, + properties: [ 'spy', 'stub', 'mock', 'sandbox' ], + // Don't fake timers by default + useFakeTimers: false, + useFakeServer: false + }; + // Extend QUnit.module to provide a Sinon sandbox. + ( function () { + var orgModule = QUnit.module; + QUnit.module = function ( name, localEnv, executeNow ) { + var orgBeforeEach, orgAfterEach, orgExecute; + if ( nested ) { + // In a nested module, don't re-run our handlers. + return orgModule.apply( this, arguments ); + } + if ( arguments.length === 2 && typeof localEnv === 'function' ) { + executeNow = localEnv; + localEnv = undefined; + } + if ( executeNow ) { + // Wrap executeNow() so that we can detect nested modules + orgExecute = executeNow; + executeNow = function () { + var ret; + nested = true; + ret = orgExecute.apply( this, arguments ); + nested = false; + return ret; + }; + } + + localEnv = localEnv || {}; + orgBeforeEach = localEnv.beforeEach; + orgAfterEach = localEnv.afterEach; + localEnv.beforeEach = function () { + var config = sinon.getConfig( sinon.config ); + config.injectInto = this; + sinon.sandbox.create( config ); + + if ( orgBeforeEach ) { + return orgBeforeEach.apply( this, arguments ); + } + }; + localEnv.afterEach = function () { + var ret; + if ( orgAfterEach ) { + ret = orgAfterEach.apply( this, arguments ); + } + + this.sandbox.verifyAndRestore(); + return ret; + }; + return orgModule( name, localEnv, executeNow ); + }; + }() ); + + // Extend QUnit.module to provide a fixture element. + ( function () { + var orgModule = QUnit.module; + QUnit.module = function ( name, localEnv, executeNow ) { + var orgBeforeEach, orgAfterEach; + if ( nested ) { + // In a nested module, don't re-run our handlers. + return orgModule.apply( this, arguments ); + } + if ( arguments.length === 2 && typeof localEnv === 'function' ) { + executeNow = localEnv; + localEnv = undefined; + } + + localEnv = localEnv || {}; + orgBeforeEach = localEnv.beforeEach; + orgAfterEach = localEnv.afterEach; + localEnv.beforeEach = function () { + this.fixture = document.createElement( 'div' ); + this.fixture.id = 'qunit-fixture'; + document.body.appendChild( this.fixture ); + + if ( orgBeforeEach ) { + return orgBeforeEach.apply( this, arguments ); + } + }; + localEnv.afterEach = function () { + var ret; + if ( orgAfterEach ) { + ret = orgAfterEach.apply( this, arguments ); + } + + this.fixture.parentNode.removeChild( this.fixture ); + return ret; + }; + return orgModule( name, localEnv, executeNow ); + }; + }() ); + + // Extend QUnit.module to normalise localEnv. + // NOTE: This MUST be the last QUnit.module extension so that the above extensions + // may safely modify the object and assume beforeEach/afterEach. + ( function () { + var orgModule = QUnit.module; + QUnit.module = function ( name, localEnv, executeNow ) { + if ( typeof localEnv === 'object' ) { + localEnv = makeSafeEnv( localEnv ); + } + return orgModule( name, localEnv, executeNow ); + }; + }() ); + + /** + * Reset mw.config and others to a fresh copy of the live config for each test(), + * and restore it back to the live one afterwards. + * + * @param {Object} [localEnv] + * @example (see test suite at the bottom of this file) + * + */ + QUnit.newMwEnvironment = ( function () { + var warn, error, liveConfig, liveMessages, + MwMap = mw.config.constructor, // internal use only + ajaxRequests = []; + + liveConfig = mw.config; + liveMessages = mw.messages; + + function suppressWarnings() { + if ( warn === undefined ) { + warn = mw.log.warn; + error = mw.log.error; + mw.log.warn = mw.log.error = $.noop; + } + } + + function restoreWarnings() { + // Guard against calls not balanced with suppressWarnings() + if ( warn !== undefined ) { + mw.log.warn = warn; + mw.log.error = error; + warn = error = undefined; + } + } + + function freshConfigCopy( custom ) { + var copy; + // Tests should mock all factors that directly influence the tested code. + // For backwards compatibility though we set mw.config to a fresh copy of the live + // config. This way any modifications made to mw.config during the test will not + // affect other tests, nor the global scope outside the test runner. + // This is a shallow copy, since overriding an array or object value via "custom" + // should replace it. Setting a config property means you override it, not extend it. + // NOTE: It is important that we suppress warnings because extend() will also access + // deprecated properties and trigger deprecation warnings from mw.log#deprecate. + suppressWarnings(); + copy = $.extend( {}, liveConfig.get(), custom ); + restoreWarnings(); + + return copy; + } + + function freshMessagesCopy( custom ) { + return $.extend( /* deep */true, {}, liveMessages.get(), custom ); + } + + /** + * @param {jQuery.Event} event + * @param {jqXHR} jqXHR + * @param {Object} ajaxOptions + */ + function trackAjax( event, jqXHR, ajaxOptions ) { + ajaxRequests.push( { xhr: jqXHR, options: ajaxOptions } ); + } + + return function ( orgEnv ) { + var localEnv = orgEnv ? makeSafeEnv( orgEnv ) : {}; + // MediaWiki env testing + localEnv.config = orgEnv && orgEnv.config || {}; + localEnv.messages = orgEnv && orgEnv.messages || {}; + + return { + beforeEach: function () { + // Greetings, mock environment! + mw.config = new MwMap(); + mw.config.set( freshConfigCopy( localEnv.config ) ); + mw.messages = new MwMap(); + mw.messages.set( freshMessagesCopy( localEnv.messages ) ); + // Update reference to mw.messages + mw.jqueryMsg.setParserDefaults( { + messages: mw.messages + } ); + + this.suppressWarnings = suppressWarnings; + this.restoreWarnings = restoreWarnings; + + // Start tracking ajax requests + $( document ).on( 'ajaxSend', trackAjax ); + + if ( localEnv.beforeEach ) { + return localEnv.beforeEach.apply( this, arguments ); + } + }, + + afterEach: function () { + var timers, pending, $activeLen, ret; + + if ( localEnv.afterEach ) { + ret = localEnv.afterEach.apply( this, arguments ); + } + + // Stop tracking ajax requests + $( document ).off( 'ajaxSend', trackAjax ); + + // As a convenience feature, automatically restore warnings if they're + // still suppressed by the end of the test. + restoreWarnings(); + + // Farewell, mock environment! + mw.config = liveConfig; + mw.messages = liveMessages; + // Restore reference to mw.messages + mw.jqueryMsg.setParserDefaults( { + messages: liveMessages + } ); + + // Tests should use fake timers or wait for animations to complete + // Check for incomplete animations/requests/etc and throw if there are any. + if ( $.timers && $.timers.length !== 0 ) { + timers = $.timers.length; + $.each( $.timers, function ( i, timer ) { + var node = timer.elem; + mw.log.warn( 'Unfinished animation #' + i + ' in ' + timer.queue + ' queue on ' + + mw.html.element( node.nodeName.toLowerCase(), $( node ).getAttrs() ) + ); + } ); + // Force animations to stop to give the next test a clean start + $.timers = []; + $.fx.stop(); + + throw new Error( 'Unfinished animations: ' + timers ); + } + + // Test should use fake XHR, wait for requests, or call abort() + $activeLen = $.active; + if ( $activeLen !== undefined && $activeLen !== 0 ) { + pending = $.grep( ajaxRequests, function ( ajax ) { + return ajax.xhr.state() === 'pending'; + } ); + if ( pending.length !== $activeLen ) { + mw.log.warn( 'Pending requests does not match jQuery.active count' ); + } + // Force requests to stop to give the next test a clean start + $.each( ajaxRequests, function ( i, ajax ) { + mw.log.warn( + 'AJAX request #' + i + ' (state: ' + ajax.xhr.state() + ')', + ajax.options + ); + ajax.xhr.abort(); + } ); + ajaxRequests = []; + + throw new Error( 'Pending AJAX requests: ' + pending.length + ' (active: ' + $activeLen + ')' ); + } + + return ret; + } + }; + }; + }() ); + + // $.when stops as soon as one fails, which makes sense in most + // practical scenarios, but not in a unit test where we really do + // need to wait until all of them are finished. + QUnit.whenPromisesComplete = function () { + var altPromises = []; + + $.each( arguments, function ( i, arg ) { + var alt = $.Deferred(); + altPromises.push( alt ); + + // Whether this one fails or not, forwards it to + // the 'done' (resolve) callback of the alternative promise. + arg.always( alt.resolve ); + } ); + + return $.when.apply( $, altPromises ); + }; + + /** + * Recursively convert a node to a plain object representing its structure. + * Only considers attributes and contents (elements and text nodes). + * Attribute values are compared strictly and not normalised. + * + * @param {Node} node + * @return {Object|string} Plain JavaScript value representing the node. + */ + function getDomStructure( node ) { + var $node, children, processedChildren, i, len, el; + $node = $( node ); + if ( node.nodeType === Node.ELEMENT_NODE ) { + children = $node.contents(); + processedChildren = []; + for ( i = 0, len = children.length; i < len; i++ ) { + el = children[ i ]; + if ( el.nodeType === Node.ELEMENT_NODE || el.nodeType === Node.TEXT_NODE ) { + processedChildren.push( getDomStructure( el ) ); + } + } + + return { + tagName: node.tagName, + attributes: $node.getAttrs(), + contents: processedChildren + }; + } else { + // Should be text node + return $node.text(); + } + } + + /** + * Gets structure of node for this HTML. + * + * @param {string} html HTML markup for one or more nodes. + */ + function getHtmlStructure( html ) { + var el = $( '
Child paragraph with A link
Regular textA spanChild paragraph with A link
Regular textA spanChild paragraph with A link
Regular textA spanChild paragraph with A link
Regular textA span