3 var specialCharactersPageName
,
4 // Can't mock SITENAME since jqueryMsg caches it at load
5 siteName
= mw
.config
.get( 'wgSiteName' );
7 // Since QUnitTestResources.php loads both mediawiki and mediawiki.jqueryMsg as
8 // dependencies, this only tests the monkey-patched behavior with the two of them combined.
10 // See mediawiki.jqueryMsg.test.js for unit tests for jqueryMsg-specific functionality.
12 QUnit
.module( 'mediawiki', QUnit
.newMwEnvironment( {
14 specialCharactersPageName
= '"Who" wants to be a millionaire & live on \'Exotic Island\'?';
17 wgArticlePath
: '/wiki/$1',
19 // For formatnum tests
22 // Messages used in multiple tests
24 'other-message': 'Other Message',
25 'mediawiki-test-pagetriage-del-talk-page-notify-summary': 'Notifying author of deletion nomination for [[$1]]',
26 'gender-plural-msg': '{{GENDER:$1|he|she|they}} {{PLURAL:$2|is|are}} awesome',
27 'grammar-msg': 'Przeszukaj {{GRAMMAR:grammar_case_foo|{{SITENAME}}}}',
28 'formatnum-msg': '{{formatnum:$1}}',
29 'int-msg': 'Some {{int:other-message}}',
30 'mediawiki-test-version-entrypoints-index-php': '[https://www.mediawiki.org/wiki/Manual:index.php index.php]',
31 'external-link-replace': 'Foo [$1 bar]'
37 QUnit
.fixurl( mw
.config
.get( 'wgScriptPath' ) + '/tests/qunit/data/load.mock.php' )
40 QUnit
.test( 'Initial check', 8, function ( assert
) {
41 assert
.ok( window
.jQuery
, 'jQuery defined' );
42 assert
.ok( window
.$, '$ defined' );
43 assert
.strictEqual( window
.$, window
.jQuery
, '$ alias to jQuery' );
45 this.suppressWarnings();
46 assert
.ok( window
.$j
, '$j defined' );
47 assert
.strictEqual( window
.$j
, window
.jQuery
, '$j alias to jQuery' );
48 this.restoreWarnings();
50 // window.mw and window.mediaWiki are not deprecated, but for some reason
51 // PhantomJS is triggerring the accessors on all mw.* properties in this test,
52 // and with that lots of unrelated deprecation notices.
53 this.suppressWarnings();
54 assert
.ok( window
.mediaWiki
, 'mediaWiki defined' );
55 assert
.ok( window
.mw
, 'mw defined' );
56 assert
.strictEqual( window
.mw
, window
.mediaWiki
, 'mw alias to mediaWiki' );
57 this.restoreWarnings();
60 QUnit
.test( 'mw.Map', 35, function ( assert
) {
61 var arry
, conf
, funky
, globalConf
, nummy
, someValues
;
65 funky = function () {};
71 assert
.strictEqual( conf
.set( 'foo', 'Bar' ), true, 'Map.set returns boolean true if a value was set for a valid key string' );
72 assert
.equal( conf
.get( 'foo' ), 'Bar', 'Map.get returns a single value value correctly' );
74 assert
.strictEqual( conf
.get( 'example' ), null, 'Map.get returns null if selection was a string and the key was not found' );
75 assert
.strictEqual( conf
.get( 'example', arry
), arry
, 'Map.get returns fallback by reference if the key was not found' );
76 assert
.strictEqual( conf
.get( 'example', undefined ), undefined, 'Map.get supports `undefined` as fallback instead of `null`' );
78 assert
.strictEqual( conf
.get( 'constructor' ), null, 'Map.get does not look at Object.prototype of internal storage (constructor)' );
79 assert
.strictEqual( conf
.get( 'hasOwnProperty' ), null, 'Map.get does not look at Object.prototype of internal storage (hasOwnProperty)' );
81 conf
.set( 'hasOwnProperty', function () { return true; } );
82 assert
.strictEqual( conf
.get( 'example', 'missing' ), 'missing', 'Map.get uses neutral hasOwnProperty method (positive)' );
84 conf
.set( 'example', 'Foo' );
85 conf
.set( 'hasOwnProperty', function () { return false; } );
86 assert
.strictEqual( conf
.get( 'example' ), 'Foo', 'Map.get uses neutral hasOwnProperty method (negative)' );
88 assert
.strictEqual( conf
.set( 'constructor', 42 ), true, 'Map.set for key "constructor"' );
89 assert
.strictEqual( conf
.get( 'constructor' ), 42, 'Map.get for key "constructor"' );
91 assert
.strictEqual( conf
.set( 'undef' ), false, 'Map.set requires explicit value (no undefined default)' );
93 assert
.strictEqual( conf
.set( 'undef', undefined ), true, 'Map.set allows setting value to `undefined`' );
94 assert
.equal( conf
.get( 'undef', 'fallback' ), undefined, 'Map.get supports retreiving value of `undefined`' );
96 assert
.strictEqual( conf
.set( funky
, 'Funky' ), false, 'Map.set returns boolean false if key was invalid (Function)' );
97 assert
.strictEqual( conf
.set( arry
, 'Arry' ), false, 'Map.set returns boolean false if key was invalid (Array)' );
98 assert
.strictEqual( conf
.set( nummy
, 'Nummy' ), false, 'Map.set returns boolean false if key was invalid (Number)' );
100 assert
.strictEqual( conf
.get( funky
), null, 'Map.get ruturns null if selection was invalid (Function)' );
101 assert
.strictEqual( conf
.get( nummy
), null, 'Map.get ruturns null if selection was invalid (Number)' );
103 conf
.set( String( nummy
), 'I used to be a number' );
105 assert
.strictEqual( conf
.exists( 'doesNotExist' ), false, 'Map.exists where property does not exist' );
106 assert
.strictEqual( conf
.exists( 'undef' ), true, 'Map.exists where value is `undefined`' );
107 assert
.strictEqual( conf
.exists( nummy
), false, 'Map.exists where key is invalid but looks like an existing key' );
109 // Multiple values at once
115 assert
.strictEqual( conf
.set( someValues
), true, 'Map.set returns boolean true if multiple values were set by passing an object' );
116 assert
.deepEqual( conf
.get( [ 'foo', 'lorem' ] ), {
119 }, 'Map.get returns multiple values correctly as an object' );
121 assert
.deepEqual( conf
, new mw
.Map( conf
.values
), 'new mw.Map maps over existing values-bearing object' );
123 assert
.deepEqual( conf
.get( [ 'foo', 'notExist' ] ), {
126 }, 'Map.get return includes keys that were not found as null values' );
128 // Interacting with globals and accessing the values object
129 assert
.strictEqual( conf
.get(), conf
.values
, 'Map.get returns the entire values object by reference (if called without arguments)' );
131 conf
.set( 'globalMapChecker', 'Hi' );
133 assert
.ok( ( 'globalMapChecker' in window
) === false, 'Map does not its store values in the window object by default' );
135 globalConf
= new mw
.Map( true );
136 globalConf
.set( 'anotherGlobalMapChecker', 'Hello' );
138 assert
.ok( 'anotherGlobalMapChecker' in window
, 'global Map stores its values in the window object' );
140 assert
.equal( globalConf
.get( 'anotherGlobalMapChecker' ), 'Hello', 'get value from global Map via get()' );
141 this.suppressWarnings();
142 assert
.equal( window
.anotherGlobalMapChecker
, 'Hello', 'get value from global Map via window object' );
143 this.restoreWarnings();
145 // Change value via global Map
146 globalConf
.set( 'anotherGlobalMapChecker', 'Again' );
147 assert
.equal( globalConf
.get( 'anotherGlobalMapChecker' ), 'Again', 'Change in global Map reflected via get()' );
148 this.suppressWarnings();
149 assert
.equal( window
.anotherGlobalMapChecker
, 'Again', 'Change in global Map reflected window object' );
150 this.restoreWarnings();
152 // Change value via window object
153 this.suppressWarnings();
154 window
.anotherGlobalMapChecker
= 'World';
155 assert
.equal( window
.anotherGlobalMapChecker
, 'World', 'Change in window object works' );
156 this.restoreWarnings();
157 assert
.equal( globalConf
.get( 'anotherGlobalMapChecker' ), 'Again', 'Change in window object not reflected in global Map' );
159 // Whitelist this global variable for QUnit's 'noglobal' mode
160 if ( QUnit
.config
.noglobals
) {
161 QUnit
.config
.pollution
.push( 'anotherGlobalMapChecker' );
165 QUnit
.test( 'mw.config', 1, function ( assert
) {
166 assert
.ok( mw
.config
instanceof mw
.Map
, 'mw.config instance of mw.Map' );
169 QUnit
.test( 'mw.message & mw.messages', 100, function ( assert
) {
172 // Convenience method for asserting the same result for multiple formats
173 function assertMultipleFormats( messageArguments
, formats
, expectedResult
, assertMessage
) {
175 len
= formats
.length
;
177 for ( i
= 0; i
< len
; i
++ ) {
178 format
= formats
[ i
];
179 assert
.equal( mw
.message
.apply( null, messageArguments
)[ format
](), expectedResult
, assertMessage
+ ' when format is ' + format
);
183 assert
.ok( mw
.messages
, 'messages defined' );
184 assert
.ok( mw
.messages
instanceof mw
.Map
, 'mw.messages instance of mw.Map' );
185 assert
.ok( mw
.messages
.set( 'hello', 'Hello <b>awesome</b> world' ), 'mw.messages.set: Register' );
187 hello
= mw
.message( 'hello' );
189 // https://phabricator.wikimedia.org/T46459
190 assert
.equal( hello
.format
, 'text', 'Message property "format" defaults to "text"' );
192 assert
.strictEqual( hello
.map
, mw
.messages
, 'Message property "map" defaults to the global instance in mw.messages' );
193 assert
.equal( hello
.key
, 'hello', 'Message property "key" (currect key)' );
194 assert
.deepEqual( hello
.parameters
, [], 'Message property "parameters" defaults to an empty array' );
197 assert
.ok( hello
.params
, 'Message prototype "params"' );
199 hello
.format
= 'plain';
200 assert
.equal( hello
.toString(), 'Hello <b>awesome</b> world', 'Message.toString returns the message as a string with the current "format"' );
202 assert
.equal( hello
.escaped(), 'Hello <b>awesome</b> world', 'Message.escaped returns the escaped message' );
203 assert
.equal( hello
.format
, 'escaped', 'Message.escaped correctly updated the "format" property' );
205 assert
.ok( mw
.messages
.set( 'multiple-curly-brace', '"{{SITENAME}}" is the home of {{int:other-message}}' ), 'mw.messages.set: Register' );
206 assertMultipleFormats( [ 'multiple-curly-brace' ], [ 'text', 'parse' ], '"' + siteName
+ '" is the home of Other Message', 'Curly brace format works correctly' );
207 assert
.equal( mw
.message( 'multiple-curly-brace' ).plain(), mw
.messages
.get( 'multiple-curly-brace' ), 'Plain format works correctly for curly brace message' );
208 assert
.equal( mw
.message( 'multiple-curly-brace' ).escaped(), mw
.html
.escape( '"' + siteName
+ '" is the home of Other Message' ), 'Escaped format works correctly for curly brace message' );
210 assert
.ok( mw
.messages
.set( 'multiple-square-brackets-and-ampersand', 'Visit the [[Project:Community portal|community portal]] & [[Project:Help desk|help desk]]' ), 'mw.messages.set: Register' );
211 assertMultipleFormats( [ 'multiple-square-brackets-and-ampersand' ], [ 'plain', 'text' ], mw
.messages
.get( 'multiple-square-brackets-and-ampersand' ), 'Square bracket message is not processed' );
212 assert
.equal( mw
.message( 'multiple-square-brackets-and-ampersand' ).escaped(), 'Visit the [[Project:Community portal|community portal]] & [[Project:Help desk|help desk]]', 'Escaped format works correctly for square bracket message' );
213 assert
.htmlEqual( mw
.message( 'multiple-square-brackets-and-ampersand' ).parse(), 'Visit the ' +
214 '<a title="Project:Community portal" href="/wiki/Project:Community_portal">community portal</a>' +
215 ' & <a title="Project:Help desk" href="/wiki/Project:Help_desk">help desk</a>', 'Internal links work with parse' );
217 assertMultipleFormats( [ 'mediawiki-test-version-entrypoints-index-php' ], [ 'plain', 'text', 'escaped' ], mw
.messages
.get( 'mediawiki-test-version-entrypoints-index-php' ), 'External link markup is unprocessed' );
218 assert
.htmlEqual( mw
.message( 'mediawiki-test-version-entrypoints-index-php' ).parse(), '<a href="https://www.mediawiki.org/wiki/Manual:index.php">index.php</a>', 'External link works correctly in parse mode' );
220 assertMultipleFormats( [ 'external-link-replace', 'http://example.org/?x=y&z' ], [ 'plain', 'text' ], 'Foo [http://example.org/?x=y&z bar]', 'Parameters are substituted but external link is not processed' );
221 assert
.equal( mw
.message( 'external-link-replace', 'http://example.org/?x=y&z' ).escaped(), 'Foo [http://example.org/?x=y&z bar]', 'In escaped mode, parameters are substituted and ampersand is escaped, but external link is not processed' );
222 assert
.htmlEqual( mw
.message( 'external-link-replace', 'http://example.org/?x=y&z' ).parse(), 'Foo <a href="http://example.org/?x=y&z">bar</a>', 'External link with replacement works in parse mode without double-escaping' );
225 assert
.equal( hello
.format
, 'parse', 'Message.parse correctly updated the "format" property' );
228 assert
.equal( hello
.format
, 'plain', 'Message.plain correctly updated the "format" property' );
231 assert
.equal( hello
.format
, 'text', 'Message.text correctly updated the "format" property' );
233 assert
.strictEqual( hello
.exists(), true, 'Message.exists returns true for existing messages' );
235 goodbye
= mw
.message( 'goodbye' );
236 assert
.strictEqual( goodbye
.exists(), false, 'Message.exists returns false for nonexistent messages' );
238 assertMultipleFormats( [ 'goodbye' ], [ 'plain', 'text' ], '<goodbye>', 'Message.toString returns <key> if key does not exist' );
240 assertMultipleFormats( [ 'goodbye' ], [ 'parse', 'escaped' ], '<goodbye>', 'Message.toString returns properly escaped <key> if key does not exist' );
242 assert
.ok( mw
.messages
.set( 'plural-test-msg', 'There {{PLURAL:$1|is|are}} $1 {{PLURAL:$1|result|results}}' ), 'mw.messages.set: Register' );
243 assertMultipleFormats( [ 'plural-test-msg', 6 ], [ 'text', 'parse', 'escaped' ], 'There are 6 results', 'plural get resolved' );
244 assert
.equal( mw
.message( 'plural-test-msg', 6 ).plain(), 'There {{PLURAL:6|is|are}} 6 {{PLURAL:6|result|results}}', 'Parameter is substituted but plural is not resolved in plain' );
246 assert
.ok( mw
.messages
.set( 'plural-test-msg-explicit', 'There {{plural:$1|is one car|are $1 cars|0=are no cars|12=are a dozen cars}}' ), 'mw.messages.set: Register message with explicit plural forms' );
247 assertMultipleFormats( [ 'plural-test-msg-explicit', 12 ], [ 'text', 'parse', 'escaped' ], 'There are a dozen cars', 'explicit plural get resolved' );
249 assert
.ok( mw
.messages
.set( 'plural-test-msg-explicit-beginning', 'Basket has {{plural:$1|0=no eggs|12=a dozen eggs|6=half a dozen eggs|one egg|$1 eggs}}' ), 'mw.messages.set: Register message with explicit plural forms' );
250 assertMultipleFormats( [ 'plural-test-msg-explicit-beginning', 1 ], [ 'text', 'parse', 'escaped' ], 'Basket has one egg', 'explicit plural given at beginning get resolved for singular' );
251 assertMultipleFormats( [ 'plural-test-msg-explicit-beginning', 4 ], [ 'text', 'parse', 'escaped' ], 'Basket has 4 eggs', 'explicit plural given at beginning get resolved for plural' );
252 assertMultipleFormats( [ 'plural-test-msg-explicit-beginning', 6 ], [ 'text', 'parse', 'escaped' ], 'Basket has half a dozen eggs', 'explicit plural given at beginning get resolved for 6' );
253 assertMultipleFormats( [ 'plural-test-msg-explicit-beginning', 0 ], [ 'text', 'parse', 'escaped' ], 'Basket has no eggs', 'explicit plural given at beginning get resolved for 0' );
255 assertMultipleFormats( [ 'mediawiki-test-pagetriage-del-talk-page-notify-summary' ], [ 'plain', 'text' ], mw
.messages
.get( 'mediawiki-test-pagetriage-del-talk-page-notify-summary' ), 'Double square brackets with no parameters unchanged' );
257 assertMultipleFormats( [ 'mediawiki-test-pagetriage-del-talk-page-notify-summary', specialCharactersPageName
], [ 'plain', 'text' ], 'Notifying author of deletion nomination for [[' + specialCharactersPageName
+ ']]', 'Double square brackets with one parameter' );
259 assert
.equal( mw
.message( 'mediawiki-test-pagetriage-del-talk-page-notify-summary', specialCharactersPageName
).escaped(), 'Notifying author of deletion nomination for [[' + mw
.html
.escape( specialCharactersPageName
) + ']]', 'Double square brackets with one parameter, when escaped' );
261 assert
.ok( mw
.messages
.set( 'mediawiki-test-categorytree-collapse-bullet', '[<b>−</b>]' ), 'mw.messages.set: Register' );
262 assert
.equal( mw
.message( 'mediawiki-test-categorytree-collapse-bullet' ).plain(), mw
.messages
.get( 'mediawiki-test-categorytree-collapse-bullet' ), 'Single square brackets unchanged in plain mode' );
264 assert
.ok( mw
.messages
.set( 'mediawiki-test-wikieditor-toolbar-help-content-signature-result', '<a href=\'#\' title=\'{{#special:mypage}}\'>Username</a> (<a href=\'#\' title=\'{{#special:mytalk}}\'>talk</a>)' ), 'mw.messages.set: Register' );
265 assert
.equal( mw
.message( 'mediawiki-test-wikieditor-toolbar-help-content-signature-result' ).plain(), mw
.messages
.get( 'mediawiki-test-wikieditor-toolbar-help-content-signature-result' ), 'HTML message with curly braces is not changed in plain mode' );
267 assertMultipleFormats( [ 'gender-plural-msg', 'male', 1 ], [ 'text', 'parse', 'escaped' ], 'he is awesome', 'Gender and plural are resolved' );
268 assert
.equal( mw
.message( 'gender-plural-msg', 'male', 1 ).plain(), '{{GENDER:male|he|she|they}} {{PLURAL:1|is|are}} awesome', 'Parameters are substituted, but gender and plural are not resolved in plain mode' );
270 assert
.equal( mw
.message( 'grammar-msg' ).plain(), mw
.messages
.get( 'grammar-msg' ), 'Grammar is not resolved in plain mode' );
271 assertMultipleFormats( [ 'grammar-msg' ], [ 'text', 'parse' ], 'Przeszukaj ' + siteName
, 'Grammar is resolved' );
272 assert
.equal( mw
.message( 'grammar-msg' ).escaped(), 'Przeszukaj ' + siteName
, 'Grammar is resolved in escaped mode' );
274 assertMultipleFormats( [ 'formatnum-msg', '987654321.654321' ], [ 'text', 'parse', 'escaped' ], '987,654,321.654', 'formatnum is resolved' );
275 assert
.equal( mw
.message( 'formatnum-msg' ).plain(), mw
.messages
.get( 'formatnum-msg' ), 'formatnum is not resolved in plain mode' );
277 assertMultipleFormats( [ 'int-msg' ], [ 'text', 'parse', 'escaped' ], 'Some Other Message', 'int is resolved' );
278 assert
.equal( mw
.message( 'int-msg' ).plain(), mw
.messages
.get( 'int-msg' ), 'int is not resolved in plain mode' );
280 assert
.ok( mw
.messages
.set( 'mediawiki-italics-msg', '<i>Very</i> important' ), 'mw.messages.set: Register' );
281 assertMultipleFormats( [ 'mediawiki-italics-msg' ], [ 'plain', 'text', 'parse' ], mw
.messages
.get( 'mediawiki-italics-msg' ), 'Simple italics unchanged' );
283 mw
.message( 'mediawiki-italics-msg' ).escaped(),
284 '<i>Very</i> important',
285 'Italics are escaped in escaped mode'
288 assert
.ok( mw
.messages
.set( 'mediawiki-italics-with-link', 'An <i>italicized [[link|wiki-link]]</i>' ), 'mw.messages.set: Register' );
289 assertMultipleFormats( [ 'mediawiki-italics-with-link' ], [ 'plain', 'text' ], mw
.messages
.get( 'mediawiki-italics-with-link' ), 'Italics with link unchanged' );
291 mw
.message( 'mediawiki-italics-with-link' ).escaped(),
292 'An <i>italicized [[link|wiki-link]]</i>',
293 'Italics and link unchanged except for escaping in escaped mode'
296 mw
.message( 'mediawiki-italics-with-link' ).parse(),
297 'An <i>italicized <a title="link" href="' + mw
.util
.getUrl( 'link' ) + '">wiki-link</i>',
298 'Italics with link inside in parse mode'
301 assert
.ok( mw
.messages
.set( 'mediawiki-script-msg', '<script >alert( "Who put this script here?" );</script>' ), 'mw.messages.set: Register' );
302 assertMultipleFormats( [ 'mediawiki-script-msg' ], [ 'plain', 'text' ], mw
.messages
.get( 'mediawiki-script-msg' ), 'Script unchanged' );
304 mw
.message( 'mediawiki-script-msg' ).escaped(),
305 '<script >alert( "Who put this script here?" );</script>',
306 'Script escaped when using escaped format'
309 mw
.message( 'mediawiki-script-msg' ).parse(),
310 '<script >alert( "Who put this script here?" );</script>',
311 'Script escaped when using parse format'
316 QUnit
.test( 'mw.msg', 14, function ( assert
) {
317 assert
.ok( mw
.messages
.set( 'hello', 'Hello <b>awesome</b> world' ), 'mw.messages.set: Register' );
318 assert
.equal( mw
.msg( 'hello' ), 'Hello <b>awesome</b> world', 'Gets message with default options (existing message)' );
319 assert
.equal( mw
.msg( 'goodbye' ), '<goodbye>', 'Gets message with default options (nonexistent message)' );
321 assert
.ok( mw
.messages
.set( 'plural-item', 'Found $1 {{PLURAL:$1|item|items}}' ), 'mw.messages.set: Register' );
322 assert
.equal( mw
.msg( 'plural-item', 5 ), 'Found 5 items', 'Apply plural for count 5' );
323 assert
.equal( mw
.msg( 'plural-item', 0 ), 'Found 0 items', 'Apply plural for count 0' );
324 assert
.equal( mw
.msg( 'plural-item', 1 ), 'Found 1 item', 'Apply plural for count 1' );
326 assert
.equal( mw
.msg( 'mediawiki-test-pagetriage-del-talk-page-notify-summary', specialCharactersPageName
), 'Notifying author of deletion nomination for [[' + specialCharactersPageName
+ ']]', 'Double square brackets in mw.msg one parameter' );
328 assert
.equal( mw
.msg( 'gender-plural-msg', 'male', 1 ), 'he is awesome', 'Gender test for male, plural count 1' );
329 assert
.equal( mw
.msg( 'gender-plural-msg', 'female', '1' ), 'she is awesome', 'Gender test for female, plural count 1' );
330 assert
.equal( mw
.msg( 'gender-plural-msg', 'unknown', 10 ), 'they are awesome', 'Gender test for neutral, plural count 10' );
332 assert
.equal( mw
.msg( 'grammar-msg' ), 'Przeszukaj ' + siteName
, 'Grammar is resolved' );
334 assert
.equal( mw
.msg( 'formatnum-msg', '987654321.654321' ), '987,654,321.654', 'formatnum is resolved' );
336 assert
.equal( mw
.msg( 'int-msg' ), 'Some Other Message', 'int is resolved' );
340 * The sync style load test (for @import). This is, in a way, also an open bug for
341 * ResourceLoader ("execute js after styles are loaded"), but browsers don't offer a
342 * way to get a callback from when a stylesheet is loaded (that is, including any
343 * `@import` rules inside). To work around this, we'll have a little time loop to check
344 * if the styles apply.
346 * Note: This test originally used new Image() and onerror to get a callback
347 * when the url is loaded, but that is fragile since it doesn't monitor the
348 * same request as the css @import, and Safari 4 has issues with
349 * onerror/onload not being fired at all in weird cases like this.
351 function assertStyleAsync( assert
, $element
, prop
, val
, fn
) {
353 el
= $element
.get( 0 ),
354 styleTestTimeout
= ( QUnit
.config
.testTimeout
|| 5000 ) - 200;
356 function isCssImportApplied() {
357 // Trigger reflow, repaint, redraw, whatever (cross-browser)
358 var x
= $element
.css( 'height' );
360 el
.className
= el
.className
;
361 x
= document
.documentElement
.clientHeight
;
363 return $element
.css( prop
) === val
;
366 function styleTestLoop() {
367 var styleTestSince
= new Date().getTime() - styleTestStart
;
368 // If it is passing or if we timed out, run the real test and stop the loop
369 if ( isCssImportApplied() || styleTestSince
> styleTestTimeout
) {
370 assert
.equal( $element
.css( prop
), val
,
371 'style "' + prop
+ ': ' + val
+ '" from url is applied (after ' + styleTestSince
+ 'ms)'
380 // Otherwise, keep polling
381 setTimeout( styleTestLoop
);
385 styleTestStart
= new Date().getTime();
389 function urlStyleTest( selector
, prop
, val
) {
391 mw
.config
.get( 'wgScriptPath' ) +
392 '/tests/qunit/data/styleTest.css.php?' +
401 QUnit
.asyncTest( 'mw.loader', 2, function ( assert
) {
404 mw
.loader
.testCallback = function () {
406 assert
.strictEqual( isAwesomeDone
, undefined, 'Implementing module is.awesome: isAwesomeDone should still be undefined' );
407 isAwesomeDone
= true;
410 mw
.loader
.implement( 'test.callback', [ QUnit
.fixurl( mw
.config
.get( 'wgScriptPath' ) + '/tests/qunit/data/callMwLoaderTestCallback.js' ) ] );
412 mw
.loader
.using( 'test.callback', function () {
414 // /sample/awesome.js declares the "mw.loader.testCallback" function
415 // which contains a call to start() and ok()
416 assert
.strictEqual( isAwesomeDone
, true, 'test.callback module should\'ve caused isAwesomeDone to be true' );
417 delete mw
.loader
.testCallback
;
421 assert
.ok( false, 'Error callback fired while loader.using "test.callback" module' );
425 QUnit
.asyncTest( 'mw.loader with Object method as module name', 2, function ( assert
) {
428 mw
.loader
.testCallback = function () {
430 assert
.strictEqual( isAwesomeDone
, undefined, 'Implementing module hasOwnProperty: isAwesomeDone should still be undefined' );
431 isAwesomeDone
= true;
434 mw
.loader
.implement( 'hasOwnProperty', [ QUnit
.fixurl( mw
.config
.get( 'wgScriptPath' ) + '/tests/qunit/data/callMwLoaderTestCallback.js' ) ], {}, {} );
436 mw
.loader
.using( 'hasOwnProperty', function () {
438 // /sample/awesome.js declares the "mw.loader.testCallback" function
439 // which contains a call to start() and ok()
440 assert
.strictEqual( isAwesomeDone
, true, 'hasOwnProperty module should\'ve caused isAwesomeDone to be true' );
441 delete mw
.loader
.testCallback
;
445 assert
.ok( false, 'Error callback fired while loader.using "hasOwnProperty" module' );
449 QUnit
.asyncTest( 'mw.loader.using( .. ) Promise', 2, function ( assert
) {
452 mw
.loader
.testCallback = function () {
454 assert
.strictEqual( isAwesomeDone
, undefined, 'Implementing module is.awesome: isAwesomeDone should still be undefined' );
455 isAwesomeDone
= true;
458 mw
.loader
.implement( 'test.promise', [ QUnit
.fixurl( mw
.config
.get( 'wgScriptPath' ) + '/tests/qunit/data/callMwLoaderTestCallback.js' ) ] );
460 mw
.loader
.using( 'test.promise' )
463 // /sample/awesome.js declares the "mw.loader.testCallback" function
464 // which contains a call to start() and ok()
465 assert
.strictEqual( isAwesomeDone
, true, 'test.promise module should\'ve caused isAwesomeDone to be true' );
466 delete mw
.loader
.testCallback
;
471 assert
.ok( false, 'Error callback fired while loader.using "test.promise" module' );
475 QUnit
.asyncTest( 'mw.loader.implement( styles={ "css": [text, ..] } )', 2, function ( assert
) {
476 var $element
= $( '<div class="mw-test-implement-a"></div>' ).appendTo( '#qunit-fixture' );
479 $element
.css( 'float' ),
488 $element
.css( 'float' ),
495 all
: '.mw-test-implement-a { float: right; }'
504 QUnit
.asyncTest( 'mw.loader.implement( styles={ "url": { <media>: [url, ..] } } )', 7, function ( assert
) {
505 var $element1
= $( '<div class="mw-test-implement-b1"></div>' ).appendTo( '#qunit-fixture' ),
506 $element2
= $( '<div class="mw-test-implement-b2"></div>' ).appendTo( '#qunit-fixture' ),
507 $element3
= $( '<div class="mw-test-implement-b3"></div>' ).appendTo( '#qunit-fixture' );
510 $element1
.css( 'text-align' ),
515 $element2
.css( 'float' ),
520 $element3
.css( 'text-align' ),
528 // Note: QUnit.start() must only be called when the entire test is
529 // complete. So, make sure that we don't start until *both*
530 // assertStyleAsync calls have completed.
532 assertStyleAsync( assert
, $element2
, 'float', 'left', function () {
533 assert
.notEqual( $element1
.css( 'text-align' ), 'center', 'print style is not applied' );
536 if ( pending
=== 0 ) {
540 assertStyleAsync( assert
, $element3
, 'float', 'right', function () {
541 assert
.notEqual( $element1
.css( 'text-align' ), 'center', 'print style is not applied' );
544 if ( pending
=== 0 ) {
551 print
: [ urlStyleTest( '.mw-test-implement-b1', 'text-align', 'center' ) ],
553 // bug 40834: Make sure it actually works with more than 1 stylesheet reference
554 urlStyleTest( '.mw-test-implement-b2', 'float', 'left' ),
555 urlStyleTest( '.mw-test-implement-b3', 'float', 'right' )
566 // Backwards compatibility
567 QUnit
.asyncTest( 'mw.loader.implement( styles={ <media>: text } ) (back-compat)', 2, function ( assert
) {
568 var $element
= $( '<div class="mw-test-implement-c"></div>' ).appendTo( '#qunit-fixture' );
571 $element
.css( 'float' ),
580 $element
.css( 'float' ),
587 all
: '.mw-test-implement-c { float: right; }'
596 // Backwards compatibility
597 QUnit
.asyncTest( 'mw.loader.implement( styles={ <media>: [url, ..] } ) (back-compat)', 4, function ( assert
) {
598 var $element
= $( '<div class="mw-test-implement-d"></div>' ).appendTo( '#qunit-fixture' ),
599 $element2
= $( '<div class="mw-test-implement-d2"></div>' ).appendTo( '#qunit-fixture' );
602 $element
.css( 'float' ),
607 $element2
.css( 'text-align' ),
615 assertStyleAsync( assert
, $element
, 'float', 'right', function () {
617 assert
.notEqual( $element2
.css( 'text-align' ), 'center', 'print style is not applied (bug 40500)' );
623 all
: [ urlStyleTest( '.mw-test-implement-d', 'float', 'right' ) ],
624 print
: [ urlStyleTest( '.mw-test-implement-d2', 'text-align', 'center' ) ]
633 // @import (bug 31676)
634 QUnit
.asyncTest( 'mw.loader.implement( styles has @import )', 7, function ( assert
) {
635 var isJsExecuted
, $element
;
638 'test.implement.import',
640 assert
.strictEqual( isJsExecuted
, undefined, 'script not executed multiple times' );
643 assert
.equal( mw
.loader
.getState( 'test.implement.import' ), 'executing', 'module state during implement() script execution' );
645 $element
= $( '<div class="mw-test-implement-import">Foo bar</div>' ).appendTo( '#qunit-fixture' );
647 assert
.equal( mw
.msg( 'test-foobar' ), 'Hello Foobar, $1!', 'messages load before script execution' );
649 assertStyleAsync( assert
, $element
, 'float', 'right', function () {
650 assert
.equal( $element
.css( 'text-align' ), 'center',
651 'CSS styles after the @import rule are working'
660 + urlStyleTest( '.mw-test-implement-import', 'float', 'right' )
662 + '.mw-test-implement-import { text-align: center; }'
666 'test-foobar': 'Hello Foobar, $1!'
670 mw
.loader
.using( 'test.implement.import' ).always( function () {
671 assert
.strictEqual( isJsExecuted
, true, 'script executed' );
672 assert
.equal( mw
.loader
.getState( 'test.implement.import' ), 'ready', 'module state after script execution' );
676 QUnit
.asyncTest( 'mw.loader.implement( dependency with styles )', 4, function ( assert
) {
677 var $element
= $( '<div class="mw-test-implement-e"></div>' ).appendTo( '#qunit-fixture' ),
678 $element2
= $( '<div class="mw-test-implement-e2"></div>' ).appendTo( '#qunit-fixture' );
681 $element
.css( 'float' ),
686 $element2
.css( 'float' ),
691 mw
.loader
.register( [
692 [ 'test.implement.e', '0', [ 'test.implement.e2' ] ],
693 [ 'test.implement.e2', '0' ]
700 $element
.css( 'float' ),
702 'Depending module\'s style is applied'
707 all
: '.mw-test-implement-e { float: right; }'
715 $element2
.css( 'float' ),
717 'Dependency\'s style is applied'
721 all
: '.mw-test-implement-e2 { float: left; }'
730 QUnit
.test( 'mw.loader.implement( only scripts )', 1, function ( assert
) {
731 mw
.loader
.implement( 'test.onlyscripts', function () {} );
732 assert
.strictEqual( mw
.loader
.getState( 'test.onlyscripts' ), 'ready' );
735 QUnit
.asyncTest( 'mw.loader.implement( only messages )', 2, function ( assert
) {
736 assert
.assertFalse( mw
.messages
.exists( 'bug_29107' ), 'Verify that the test message doesn\'t exist yet' );
738 // jscs: disable requireCamelCaseOrUpperCaseIdentifiers
739 mw
.loader
.implement( 'test.implement.msgs', [], {}, { bug_29107
: 'loaded' } );
740 // jscs: enable requireCamelCaseOrUpperCaseIdentifiers
741 mw
.loader
.using( 'test.implement.msgs', function () {
743 assert
.ok( mw
.messages
.exists( 'bug_29107' ), 'Bug 29107: messages-only module should implement ok' );
746 assert
.ok( false, 'Error callback fired while implementing "test.implement.msgs" module' );
750 QUnit
.test( 'mw.loader with broken indirect dependency', 4, function ( assert
) {
751 // don't emit an error event
752 this.sandbox
.stub( mw
, 'track' );
754 mw
.loader
.register( [
755 [ 'test.module1', '0' ],
756 [ 'test.module2', '0', [ 'test.module1' ] ],
757 [ 'test.module3', '0', [ 'test.module2' ] ]
759 mw
.loader
.implement( 'test.module1', function () {
760 throw new Error( 'expected' );
762 assert
.strictEqual( mw
.loader
.getState( 'test.module1' ), 'error', 'Expected "error" state for test.module1' );
763 assert
.strictEqual( mw
.loader
.getState( 'test.module2' ), 'error', 'Expected "error" state for test.module2' );
764 assert
.strictEqual( mw
.loader
.getState( 'test.module3' ), 'error', 'Expected "error" state for test.module3' );
766 assert
.strictEqual( mw
.track
.callCount
, 1 );
769 QUnit
.test( 'mw.loader with circular dependency', 1, function ( assert
) {
770 mw
.loader
.register( [
771 [ 'test.circle1', '0', [ 'test.circle2' ] ],
772 [ 'test.circle2', '0', [ 'test.circle3' ] ],
773 [ 'test.circle3', '0', [ 'test.circle1' ] ]
775 assert
.throws( function () {
776 mw
.loader
.using( 'test.circle3' );
777 }, /Circular/, 'Detect circular dependency' );
780 QUnit
.test( 'mw.loader out-of-order implementation', 9, function ( assert
) {
781 mw
.loader
.register( [
782 [ 'test.module4', '0' ],
783 [ 'test.module5', '0', [ 'test.module4' ] ],
784 [ 'test.module6', '0', [ 'test.module5' ] ]
786 mw
.loader
.implement( 'test.module4', function () {} );
787 assert
.strictEqual( mw
.loader
.getState( 'test.module4' ), 'ready', 'Expected "ready" state for test.module4' );
788 assert
.strictEqual( mw
.loader
.getState( 'test.module5' ), 'registered', 'Expected "registered" state for test.module5' );
789 assert
.strictEqual( mw
.loader
.getState( 'test.module6' ), 'registered', 'Expected "registered" state for test.module6' );
790 mw
.loader
.implement( 'test.module6', function () {} );
791 assert
.strictEqual( mw
.loader
.getState( 'test.module4' ), 'ready', 'Expected "ready" state for test.module4' );
792 assert
.strictEqual( mw
.loader
.getState( 'test.module5' ), 'registered', 'Expected "registered" state for test.module5' );
793 assert
.strictEqual( mw
.loader
.getState( 'test.module6' ), 'loaded', 'Expected "loaded" state for test.module6' );
794 mw
.loader
.implement( 'test.module5', function () {} );
795 assert
.strictEqual( mw
.loader
.getState( 'test.module4' ), 'ready', 'Expected "ready" state for test.module4' );
796 assert
.strictEqual( mw
.loader
.getState( 'test.module5' ), 'ready', 'Expected "ready" state for test.module5' );
797 assert
.strictEqual( mw
.loader
.getState( 'test.module6' ), 'ready', 'Expected "ready" state for test.module6' );
800 QUnit
.test( 'mw.loader missing dependency', 13, function ( assert
) {
801 mw
.loader
.register( [
802 [ 'test.module7', '0' ],
803 [ 'test.module8', '0', [ 'test.module7' ] ],
804 [ 'test.module9', '0', [ 'test.module8' ] ]
806 mw
.loader
.implement( 'test.module8', function () {} );
807 assert
.strictEqual( mw
.loader
.getState( 'test.module7' ), 'registered', 'Expected "registered" state for test.module7' );
808 assert
.strictEqual( mw
.loader
.getState( 'test.module8' ), 'loaded', 'Expected "loaded" state for test.module8' );
809 assert
.strictEqual( mw
.loader
.getState( 'test.module9' ), 'registered', 'Expected "registered" state for test.module9' );
810 mw
.loader
.state( 'test.module7', 'missing' );
811 assert
.strictEqual( mw
.loader
.getState( 'test.module7' ), 'missing', 'Expected "missing" state for test.module7' );
812 assert
.strictEqual( mw
.loader
.getState( 'test.module8' ), 'error', 'Expected "error" state for test.module8' );
813 assert
.strictEqual( mw
.loader
.getState( 'test.module9' ), 'error', 'Expected "error" state for test.module9' );
814 mw
.loader
.implement( 'test.module9', function () {} );
815 assert
.strictEqual( mw
.loader
.getState( 'test.module7' ), 'missing', 'Expected "missing" state for test.module7' );
816 assert
.strictEqual( mw
.loader
.getState( 'test.module8' ), 'error', 'Expected "error" state for test.module8' );
817 assert
.strictEqual( mw
.loader
.getState( 'test.module9' ), 'error', 'Expected "error" state for test.module9' );
821 assert
.ok( false, 'Success fired despite missing dependency' );
822 assert
.ok( true, 'QUnit expected() count dummy' );
824 function ( e
, dependencies
) {
825 assert
.strictEqual( $.isArray( dependencies
), true, 'Expected array of dependencies' );
826 assert
.deepEqual( dependencies
, [ 'test.module7' ], 'Error callback called with module test.module7' );
832 assert
.ok( false, 'Success fired despite missing dependency' );
833 assert
.ok( true, 'QUnit expected() count dummy' );
835 function ( e
, dependencies
) {
836 assert
.strictEqual( $.isArray( dependencies
), true, 'Expected array of dependencies' );
840 [ 'test.module7', 'test.module8', 'test.module9' ],
841 'Error callback called with all three modules as dependencies'
847 QUnit
.asyncTest( 'mw.loader dependency handling', 5, function ( assert
) {
848 mw
.loader
.register( [
849 // [module, version, dependencies, group, source]
850 [ 'testMissing', '1', [], null, 'testloader' ],
851 [ 'testUsesMissing', '1', [ 'testMissing' ], null, 'testloader' ],
852 [ 'testUsesNestedMissing', '1', [ 'testUsesMissing' ], null, 'testloader' ]
855 function verifyModuleStates() {
856 assert
.equal( mw
.loader
.getState( 'testMissing' ), 'missing', 'Module not known to server must have state "missing"' );
857 assert
.equal( mw
.loader
.getState( 'testUsesMissing' ), 'error', 'Module with missing dependency must have state "error"' );
858 assert
.equal( mw
.loader
.getState( 'testUsesNestedMissing' ), 'error', 'Module with indirect missing dependency must have state "error"' );
861 mw
.loader
.using( [ 'testUsesNestedMissing' ],
863 assert
.ok( false, 'Error handler should be invoked.' );
864 assert
.ok( true ); // Dummy to reach QUnit expect()
866 verifyModuleStates();
870 function ( e
, badmodules
) {
871 assert
.ok( true, 'Error handler should be invoked.' );
872 // As soon as server spits out state('testMissing', 'missing');
873 // it will bubble up and trigger the error callback.
874 // Therefor the badmodules array is not testUsesMissing or testUsesNestedMissing.
875 assert
.deepEqual( badmodules
, [ 'testMissing' ], 'Bad modules as expected.' );
877 verifyModuleStates();
884 QUnit
.asyncTest( 'mw.loader skin-function handling', 5, function ( assert
) {
885 mw
.loader
.register( [
886 // [module, version, dependencies, group, source, skip]
887 [ 'testSkipped', '1', [], null, 'testloader', 'return true;' ],
888 [ 'testNotSkipped', '1', [], null, 'testloader', 'return false;' ],
889 [ 'testUsesSkippable', '1', [ 'testSkipped', 'testNotSkipped' ], null, 'testloader' ]
892 function verifyModuleStates() {
893 assert
.equal( mw
.loader
.getState( 'testSkipped' ), 'ready', 'Module is ready when skipped' );
894 assert
.equal( mw
.loader
.getState( 'testNotSkipped' ), 'ready', 'Module is ready when not skipped but loaded' );
895 assert
.equal( mw
.loader
.getState( 'testUsesSkippable' ), 'ready', 'Module is ready when skippable dependencies are ready' );
898 mw
.loader
.using( [ 'testUsesSkippable' ],
900 assert
.ok( true, 'Success handler should be invoked.' );
901 assert
.ok( true ); // Dummy to match error handler and reach QUnit expect()
903 verifyModuleStates();
907 function ( e
, badmodules
) {
908 assert
.ok( false, 'Error handler should not be invoked.' );
909 assert
.deepEqual( badmodules
, [], 'Bad modules as expected.' );
911 verifyModuleStates();
918 QUnit
.asyncTest( 'mw.loader( "//protocol-relative" ) (bug 30825)', 2, function ( assert
) {
919 // This bug was actually already fixed in 1.18 and later when discovered in 1.17.
920 // Test is for regressions!
922 // Forge a URL to the test callback script
923 var target
= QUnit
.fixurl(
924 mw
.config
.get( 'wgServer' ) + mw
.config
.get( 'wgScriptPath' ) + '/tests/qunit/data/qunitOkCall.js'
927 // Confirm that mw.loader.load() works with protocol-relative URLs
928 target
= target
.replace( /https?:/, '' );
930 assert
.equal( target
.slice( 0, 2 ), '//',
931 'URL must be relative to test relative URLs!'
935 // The target calls QUnit.start
936 mw
.loader
.load( target
);
939 QUnit
.asyncTest( 'mw.loader( "/absolute-path" )', 2, function ( assert
) {
940 // Forge a URL to the test callback script
941 var target
= QUnit
.fixurl(
942 mw
.config
.get( 'wgScriptPath' ) + '/tests/qunit/data/qunitOkCall.js'
945 // Confirm that mw.loader.load() works with absolute-paths (relative to current hostname)
946 assert
.equal( target
.slice( 0, 1 ), '/', 'URL is relative to document root' );
949 // The target calls QUnit.start
950 mw
.loader
.load( target
);
953 QUnit
.asyncTest( 'mw.loader() executing race (T112232)', 2, function ( assert
) {
956 // The red herring schedules its CSS buffer first. In T112232, a bug in the
957 // state machine would cause the job for testRaceLoadMe to run with an earlier job.
959 'testRaceRedHerring',
961 { css
: [ '.mw-testRaceRedHerring {}' ] }
968 { css
: [ '.mw-testRaceLoadMe { float: left; }' ] }
971 mw
.loader
.load( [ 'testRaceRedHerring', 'testRaceLoadMe' ] );
972 mw
.loader
.using( 'testRaceLoadMe', function () {
973 assert
.strictEqual( done
, true, 'script ran' );
974 assert
.strictEqual( mw
.loader
.getState( 'testRaceLoadMe' ), 'ready', 'state' );
975 } ).always( QUnit
.start
);
978 QUnit
.test( 'mw.hook', 13, function ( assert
) {
979 var hook
, add
, fire
, chars
, callback
;
981 mw
.hook( 'test.hook.unfired' ).add( function () {
982 assert
.ok( false, 'Unfired hook' );
985 mw
.hook( 'test.hook.basic' ).add( function () {
986 assert
.ok( true, 'Basic callback' );
988 mw
.hook( 'test.hook.basic' ).fire();
990 mw
.hook( 'hasOwnProperty' ).add( function () {
991 assert
.ok( true, 'hook with name of predefined method' );
993 mw
.hook( 'hasOwnProperty' ).fire();
995 mw
.hook( 'test.hook.data' ).add( function ( data1
, data2
) {
996 assert
.equal( data1
, 'example', 'Fire with data (string param)' );
997 assert
.deepEqual( data2
, [ 'two' ], 'Fire with data (array param)' );
999 mw
.hook( 'test.hook.data' ).fire( 'example', [ 'two' ] );
1001 hook
= mw
.hook( 'test.hook.chainable' );
1002 assert
.strictEqual( hook
.add(), hook
, 'hook.add is chainable' );
1003 assert
.strictEqual( hook
.remove(), hook
, 'hook.remove is chainable' );
1004 assert
.strictEqual( hook
.fire(), hook
, 'hook.fire is chainable' );
1006 hook
= mw
.hook( 'test.hook.detach' );
1009 add( function ( x
, y
) {
1010 assert
.deepEqual( [ x
, y
], [ 'x', 'y' ], 'Detached (contextless) with data' );
1014 mw
.hook( 'test.hook.fireBefore' ).fire().add( function () {
1015 assert
.ok( true, 'Invoke handler right away if it was fired before' );
1018 mw
.hook( 'test.hook.fireTwiceBefore' ).fire().fire().add( function () {
1019 assert
.ok( true, 'Invoke handler right away if it was fired before (only last one)' );
1024 mw
.hook( 'test.hook.many' )
1025 .add( function ( chr
) {
1028 .fire( 'x' ).fire( 'y' ).fire( 'z' )
1029 .add( function ( chr
) {
1030 assert
.equal( chr
, 'z', 'Adding callback later invokes right away with last data' );
1033 assert
.deepEqual( chars
, [ 'x', 'y', 'z' ], 'Multiple callbacks with multiple fires' );
1036 callback = function ( chr
) {
1040 mw
.hook( 'test.hook.variadic' )
1062 [ 'x', 'x', 'x', 'x', 'y', 'z' ],
1063 '"add" and "remove" support variadic arguments. ' +
1064 '"add" does not filter unique. ' +
1065 '"remove" removes all equal by reference. ' +
1066 '"remove" is silent if the function is not found'
1070 }( mediaWiki
, jQuery
) );