aboutsummaryrefslogtreecommitdiffstats
path: root/tests/lib/helper.js
blob: 2be4c48deac98725bf1c36e6630cc03cfbd487b0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
define( [
	"jquery"
], function( $ ) {

var exports = {},

	// Store the old count so that we only assert on tests that have actually leaked,
	// instead of asserting every time a test has leaked sometime in the past
	oldActive = 0,
	splice = [].splice;

exports.forceScrollableWindow = function( appendTo ) {

	// The main testable area is 10000x10000 so to enforce scrolling,
	// this DIV must be greater than 10000 to work
	return $( "<div>" )
		.css( {
			height: "11000px",
			width: "11000px"
		} )
		.appendTo( appendTo || "#qunit-fixture" );
};

exports.onFocus = function( element, onFocus ) {
	var fn = function( event ) {
		if ( !event.originalEvent ) {
			return;
		}
		element.off( "focus", fn );
		onFocus();
	};

	element.on( "focus", fn )[ 0 ].focus();
};

/**
 * Ensures that tests have cleaned up properly after themselves. Should be passed as the
 * afterEach function on all modules' lifecycle object.
 */
exports.moduleAfterEach = function( assert ) {

	// Check for (and clean up, if possible) incomplete animations/requests/etc.
	if ( jQuery.timers && jQuery.timers.length !== 0 ) {
		assert.equal( jQuery.timers.length, 0, "No timers are still running" );
		splice.call( jQuery.timers, 0, jQuery.timers.length );
		jQuery.fx.stop();
	}
	if ( jQuery.active !== undefined && jQuery.active !== oldActive ) {
		assert.equal( jQuery.active, oldActive, "No AJAX requests are still active" );
		oldActive = jQuery.active;
	}
};

exports.testIframe = function( title, fileName, func, wrapper, iframeStyles ) {
	if ( !wrapper ) {
		wrapper = QUnit.test;
	}
	wrapper.call( QUnit, title, function( assert ) {
		var done = assert.async(),
			$iframe = jQuery( "<iframe></iframe>" )
				.css( {
					position: "absolute",
					top: "0",
					left: "-600px",
					width: "500px",
					zIndex: 1,
					background: "white"
				} )
				.attr( { id: "qunit-fixture-iframe", src: fileName } );

		// Add other iframe styles
		if ( iframeStyles ) {
			$iframe.css( iframeStyles );
		}

		// Test iframes are expected to invoke this via startIframeTest
		// (cf. iframeTest.js)
		window.iframeCallback = function() {
			var args = Array.prototype.slice.call( arguments );

			args.unshift( assert );

			setTimeout( function() {
				var result;

				this.iframeCallback = undefined;

				result = func.apply( this, args );

				function finish() {
					func = function() {};
					$iframe.remove();
					done();
				}

				// Wait for promises returned by `func`.
				if ( result && result.then ) {
					result.then( finish );
				} else {
					finish();
				}
			} );
		};

		// Attach iframe to the body for visibility-dependent code.
		// It will be removed by either the above code, or the testDone
		// callback in qunit.js.
		$iframe.prependTo( document.body );
	} );
};
window.iframeCallback = undefined;

return exports;

} );