resourceloader: Return a promise from mw.loader.using()
[lhc/web/wiklou.git] / tests / qunit / suites / resources / mediawiki / mediawiki.test.js
1 ( function ( mw, $ ) {
2 var specialCharactersPageName;
3
4 // Since QUnitTestResources.php loads both mediawiki and mediawiki.jqueryMsg as
5 // dependencies, this only tests the monkey-patched behavior with the two of them combined.
6
7 // See mediawiki.jqueryMsg.test.js for unit tests for jqueryMsg-specific functionality.
8
9 QUnit.module( 'mediawiki', QUnit.newMwEnvironment( {
10 setup: function () {
11 // Messages used in multiple tests
12 mw.messages.set( {
13 'other-message': 'Other Message',
14 'mediawiki-test-pagetriage-del-talk-page-notify-summary': 'Notifying author of deletion nomination for [[$1]]',
15 'gender-plural-msg': '{{GENDER:$1|he|she|they}} {{PLURAL:$2|is|are}} awesome',
16 'grammar-msg': 'Przeszukaj {{GRAMMAR:grammar_case_foo|{{SITENAME}}}}',
17 'formatnum-msg': '{{formatnum:$1}}',
18 'int-msg': 'Some {{int:other-message}}',
19 'mediawiki-test-version-entrypoints-index-php': '[https://www.mediawiki.org/wiki/Manual:index.php index.php]',
20 'external-link-replace': 'Foo [$1 bar]'
21 } );
22
23 mw.config.set( {
24 wgArticlePath: '/wiki/$1',
25
26 // For formatnum tests
27 wgUserLanguage: 'en'
28 } );
29
30 specialCharactersPageName = '"Who" wants to be a millionaire & live on \'Exotic Island\'?';
31 }
32 } ) );
33
34 QUnit.test( 'Initial check', 8, function ( assert ) {
35 assert.ok( window.jQuery, 'jQuery defined' );
36 assert.ok( window.$, '$j defined' );
37 assert.ok( window.$j, '$j defined' );
38 assert.strictEqual( window.$, window.jQuery, '$ alias to jQuery' );
39 assert.strictEqual( window.$j, window.jQuery, '$j alias to jQuery' );
40
41 assert.ok( window.mediaWiki, 'mediaWiki defined' );
42 assert.ok( window.mw, 'mw defined' );
43 assert.strictEqual( window.mw, window.mediaWiki, 'mw alias to mediaWiki' );
44 } );
45
46 QUnit.test( 'mw.Map', 28, function ( assert ) {
47 var arry, conf, funky, globalConf, nummy, someValues;
48
49 conf = new mw.Map();
50 // Dummy variables
51 funky = function () {};
52 arry = [];
53 nummy = 7;
54
55 // Single get and set
56
57 assert.strictEqual( conf.set( 'foo', 'Bar' ), true, 'Map.set returns boolean true if a value was set for a valid key string' );
58 assert.equal( conf.get( 'foo' ), 'Bar', 'Map.get returns a single value value correctly' );
59
60 assert.strictEqual( conf.get( 'example' ), null, 'Map.get returns null if selection was a string and the key was not found' );
61 assert.strictEqual( conf.get( 'example', arry ), arry, 'Map.get returns fallback by reference if the key was not found' );
62 assert.strictEqual( conf.get( 'example', undefined ), undefined, 'Map.get supports `undefined` as fallback instead of `null`' );
63
64 assert.strictEqual( conf.get( 'constructor' ), null, 'Map.get does not look at Object.prototype of internal storage (constructor)' );
65 assert.strictEqual( conf.get( 'hasOwnProperty' ), null, 'Map.get does not look at Object.prototype of internal storage (hasOwnProperty)' );
66
67 conf.set( 'hasOwnProperty', function () { return true; } );
68 assert.strictEqual( conf.get( 'example', 'missing' ), 'missing', 'Map.get uses neutral hasOwnProperty method (positive)' );
69
70 conf.set( 'example', 'Foo' );
71 conf.set( 'hasOwnProperty', function () { return false; } );
72 assert.strictEqual( conf.get( 'example' ), 'Foo', 'Map.get uses neutral hasOwnProperty method (negative)' );
73
74 assert.strictEqual( conf.set( 'constructor', 42 ), true, 'Map.set for key "constructor"' );
75 assert.strictEqual( conf.get( 'constructor' ), 42, 'Map.get for key "constructor"' );
76
77 assert.strictEqual( conf.set( 'ImUndefined', undefined ), true, 'Map.set allows setting value to `undefined`' );
78 assert.equal( conf.get( 'ImUndefined', 'fallback' ), undefined, 'Map.get supports retreiving value of `undefined`' );
79
80 assert.strictEqual( conf.set( funky, 'Funky' ), false, 'Map.set returns boolean false if key was invalid (Function)' );
81 assert.strictEqual( conf.set( arry, 'Arry' ), false, 'Map.set returns boolean false if key was invalid (Array)' );
82 assert.strictEqual( conf.set( nummy, 'Nummy' ), false, 'Map.set returns boolean false if key was invalid (Number)' );
83
84 assert.strictEqual( conf.get( funky ), null, 'Map.get ruturns null if selection was invalid (Function)' );
85 assert.strictEqual( conf.get( nummy ), null, 'Map.get ruturns null if selection was invalid (Number)' );
86
87 conf.set( String( nummy ), 'I used to be a number' );
88
89 assert.strictEqual( conf.exists( 'doesNotExist' ), false, 'Map.exists where property does not exist' );
90 assert.strictEqual( conf.exists( 'ImUndefined' ), true, 'Map.exists where value is `undefined`' );
91 assert.strictEqual( conf.exists( nummy ), false, 'Map.exists where key is invalid but looks like an existing key' );
92
93 // Multiple values at once
94 someValues = {
95 'foo': 'bar',
96 'lorem': 'ipsum',
97 'MediaWiki': true
98 };
99 assert.strictEqual( conf.set( someValues ), true, 'Map.set returns boolean true if multiple values were set by passing an object' );
100 assert.deepEqual( conf.get( ['foo', 'lorem'] ), {
101 'foo': 'bar',
102 'lorem': 'ipsum'
103 }, 'Map.get returns multiple values correctly as an object' );
104
105 assert.deepEqual( conf, new mw.Map( conf.values ), 'new mw.Map maps over existing values-bearing object' );
106
107 assert.deepEqual( conf.get( ['foo', 'notExist'] ), {
108 'foo': 'bar',
109 'notExist': null
110 }, 'Map.get return includes keys that were not found as null values' );
111
112 // Interacting with globals and accessing the values object
113 assert.strictEqual( conf.get(), conf.values, 'Map.get returns the entire values object by reference (if called without arguments)' );
114
115 conf.set( 'globalMapChecker', 'Hi' );
116
117 assert.ok( 'globalMapChecker' in window === false, 'new mw.Map did not store its values in the global window object by default' );
118
119 globalConf = new mw.Map( true );
120 globalConf.set( 'anotherGlobalMapChecker', 'Hello' );
121
122 assert.ok( 'anotherGlobalMapChecker' in window, 'new mw.Map( true ) did store its values in the global window object' );
123
124 // Whitelist this global variable for QUnit's 'noglobal' mode
125 if ( QUnit.config.noglobals ) {
126 QUnit.config.pollution.push( 'anotherGlobalMapChecker' );
127 }
128 } );
129
130 QUnit.test( 'mw.config', 1, function ( assert ) {
131 assert.ok( mw.config instanceof mw.Map, 'mw.config instance of mw.Map' );
132 } );
133
134 QUnit.test( 'mw.message & mw.messages', 100, function ( assert ) {
135 var goodbye, hello;
136
137 // Convenience method for asserting the same result for multiple formats
138 function assertMultipleFormats( messageArguments, formats, expectedResult, assertMessage ) {
139 var len = formats.length, format, i;
140 for ( i = 0; i < len; i++ ) {
141 format = formats[i];
142 assert.equal( mw.message.apply( null, messageArguments )[format](), expectedResult, assertMessage + ' when format is ' + format );
143 }
144 }
145
146 assert.ok( mw.messages, 'messages defined' );
147 assert.ok( mw.messages instanceof mw.Map, 'mw.messages instance of mw.Map' );
148 assert.ok( mw.messages.set( 'hello', 'Hello <b>awesome</b> world' ), 'mw.messages.set: Register' );
149
150 hello = mw.message( 'hello' );
151
152 // https://bugzilla.wikimedia.org/show_bug.cgi?id=44459
153 assert.equal( hello.format, 'text', 'Message property "format" defaults to "text"' );
154
155 assert.strictEqual( hello.map, mw.messages, 'Message property "map" defaults to the global instance in mw.messages' );
156 assert.equal( hello.key, 'hello', 'Message property "key" (currect key)' );
157 assert.deepEqual( hello.parameters, [], 'Message property "parameters" defaults to an empty array' );
158
159 // Todo
160 assert.ok( hello.params, 'Message prototype "params"' );
161
162 hello.format = 'plain';
163 assert.equal( hello.toString(), 'Hello <b>awesome</b> world', 'Message.toString returns the message as a string with the current "format"' );
164
165 assert.equal( hello.escaped(), 'Hello &lt;b&gt;awesome&lt;/b&gt; world', 'Message.escaped returns the escaped message' );
166 assert.equal( hello.format, 'escaped', 'Message.escaped correctly updated the "format" property' );
167
168 assert.ok( mw.messages.set( 'multiple-curly-brace', '"{{SITENAME}}" is the home of {{int:other-message}}' ), 'mw.messages.set: Register' );
169 assertMultipleFormats( ['multiple-curly-brace'], ['text', 'parse'], '"' + mw.config.get( 'wgSiteName') + '" is the home of Other Message', 'Curly brace format works correctly' );
170 assert.equal( mw.message( 'multiple-curly-brace' ).plain(), mw.messages.get( 'multiple-curly-brace' ), 'Plain format works correctly for curly brace message' );
171 assert.equal( mw.message( 'multiple-curly-brace' ).escaped(), mw.html.escape( '"' + mw.config.get( 'wgSiteName') + '" is the home of Other Message' ), 'Escaped format works correctly for curly brace message' );
172
173 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' );
174 assertMultipleFormats( ['multiple-square-brackets-and-ampersand'], ['plain', 'text'], mw.messages.get( 'multiple-square-brackets-and-ampersand' ), 'Square bracket message is not processed' );
175 assert.equal( mw.message( 'multiple-square-brackets-and-ampersand' ).escaped(), 'Visit the [[Project:Community portal|community portal]] &amp; [[Project:Help desk|help desk]]', 'Escaped format works correctly for square bracket message' );
176 assert.htmlEqual( mw.message( 'multiple-square-brackets-and-ampersand' ).parse(), 'Visit the ' +
177 '<a title="Project:Community portal" href="/wiki/Project:Community_portal">community portal</a>' +
178 ' &amp; <a title="Project:Help desk" href="/wiki/Project:Help_desk">help desk</a>', 'Internal links work with parse' );
179
180 assertMultipleFormats( ['mediawiki-test-version-entrypoints-index-php'], ['plain', 'text', 'escaped'], mw.messages.get( 'mediawiki-test-version-entrypoints-index-php' ), 'External link markup is unprocessed' );
181 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' );
182
183 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' );
184 assert.equal( mw.message( 'external-link-replace', 'http://example.org/?x=y&z' ).escaped(), 'Foo [http://example.org/?x=y&amp;z bar]', 'In escaped mode, parameters are substituted and ampersand is escaped, but external link is not processed' );
185 assert.htmlEqual( mw.message( 'external-link-replace', 'http://example.org/?x=y&z' ).parse(), 'Foo <a href="http://example.org/?x=y&amp;z">bar</a>', 'External link with replacement works in parse mode without double-escaping' );
186
187 hello.parse();
188 assert.equal( hello.format, 'parse', 'Message.parse correctly updated the "format" property' );
189
190 hello.plain();
191 assert.equal( hello.format, 'plain', 'Message.plain correctly updated the "format" property' );
192
193 hello.text();
194 assert.equal( hello.format, 'text', 'Message.text correctly updated the "format" property' );
195
196 assert.strictEqual( hello.exists(), true, 'Message.exists returns true for existing messages' );
197
198 goodbye = mw.message( 'goodbye' );
199 assert.strictEqual( goodbye.exists(), false, 'Message.exists returns false for nonexistent messages' );
200
201 assertMultipleFormats( ['goodbye'], ['plain', 'text'], '<goodbye>', 'Message.toString returns <key> if key does not exist' );
202 // bug 30684
203 assertMultipleFormats( ['goodbye'], ['parse', 'escaped'], '&lt;goodbye&gt;', 'Message.toString returns properly escaped &lt;key&gt; if key does not exist' );
204
205 assert.ok( mw.messages.set( 'plural-test-msg', 'There {{PLURAL:$1|is|are}} $1 {{PLURAL:$1|result|results}}' ), 'mw.messages.set: Register' );
206 assertMultipleFormats( ['plural-test-msg', 6], ['text', 'parse', 'escaped'], 'There are 6 results', 'plural get resolved' );
207 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' );
208
209 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' );
210 assertMultipleFormats( ['plural-test-msg-explicit', 12], ['text', 'parse', 'escaped'], 'There are a dozen cars', 'explicit plural get resolved' );
211
212 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' );
213 assertMultipleFormats( ['plural-test-msg-explicit-beginning', 1], ['text', 'parse', 'escaped'], 'Basket has one egg', 'explicit plural given at beginning get resolved for singular' );
214 assertMultipleFormats( ['plural-test-msg-explicit-beginning', 4], ['text', 'parse', 'escaped'], 'Basket has 4 eggs', 'explicit plural given at beginning get resolved for plural' );
215 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' );
216 assertMultipleFormats( ['plural-test-msg-explicit-beginning', 0], ['text', 'parse', 'escaped'], 'Basket has no eggs', 'explicit plural given at beginning get resolved for 0' );
217
218 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' );
219
220 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' );
221
222 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' );
223
224 assert.ok( mw.messages.set( 'mediawiki-test-categorytree-collapse-bullet', '[<b>−</b>]' ), 'mw.messages.set: Register' );
225 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' );
226
227 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' );
228 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' );
229
230 assertMultipleFormats( ['gender-plural-msg', 'male', 1], ['text', 'parse', 'escaped'], 'he is awesome', 'Gender and plural are resolved' );
231 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' );
232
233 assert.equal( mw.message( 'grammar-msg' ).plain(), mw.messages.get( 'grammar-msg' ), 'Grammar is not resolved in plain mode' );
234 assertMultipleFormats( ['grammar-msg'], ['text', 'parse'], 'Przeszukaj ' + mw.config.get( 'wgSiteName' ), 'Grammar is resolved' );
235 assert.equal( mw.message( 'grammar-msg' ).escaped(), 'Przeszukaj ' + mw.html.escape( mw.config.get( 'wgSiteName' ) ), 'Grammar is resolved in escaped mode' );
236
237 assertMultipleFormats( ['formatnum-msg', '987654321.654321'], ['text', 'parse', 'escaped'], '987,654,321.654', 'formatnum is resolved' );
238 assert.equal( mw.message( 'formatnum-msg' ).plain(), mw.messages.get( 'formatnum-msg' ), 'formatnum is not resolved in plain mode' );
239
240 assertMultipleFormats( ['int-msg'], ['text', 'parse', 'escaped'], 'Some Other Message', 'int is resolved' );
241 assert.equal( mw.message( 'int-msg' ).plain(), mw.messages.get( 'int-msg' ), 'int is not resolved in plain mode' );
242
243 assert.ok( mw.messages.set( 'mediawiki-italics-msg', '<i>Very</i> important' ), 'mw.messages.set: Register' );
244 assertMultipleFormats( ['mediawiki-italics-msg'], ['plain', 'text', 'parse'], mw.messages.get( 'mediawiki-italics-msg' ), 'Simple italics unchanged' );
245 assert.htmlEqual(
246 mw.message( 'mediawiki-italics-msg' ).escaped(),
247 '&lt;i&gt;Very&lt;/i&gt; important',
248 'Italics are escaped in escaped mode'
249 );
250
251 assert.ok( mw.messages.set( 'mediawiki-italics-with-link', 'An <i>italicized [[link|wiki-link]]</i>' ), 'mw.messages.set: Register' );
252 assertMultipleFormats( ['mediawiki-italics-with-link'], ['plain', 'text'], mw.messages.get( 'mediawiki-italics-with-link' ), 'Italics with link unchanged' );
253 assert.htmlEqual(
254 mw.message( 'mediawiki-italics-with-link' ).escaped(),
255 'An &lt;i&gt;italicized [[link|wiki-link]]&lt;/i&gt;',
256 'Italics and link unchanged except for escaping in escaped mode'
257 );
258 assert.htmlEqual(
259 mw.message( 'mediawiki-italics-with-link' ).parse(),
260 'An <i>italicized <a title="link" href="' + mw.util.getUrl( 'link' ) + '">wiki-link</i>',
261 'Italics with link inside in parse mode'
262 );
263
264 assert.ok( mw.messages.set( 'mediawiki-script-msg', '<script >alert( "Who put this script here?" );</script>' ), 'mw.messages.set: Register' );
265 assertMultipleFormats( ['mediawiki-script-msg'], ['plain', 'text'], mw.messages.get( 'mediawiki-script-msg' ), 'Script unchanged' );
266 assert.htmlEqual(
267 mw.message( 'mediawiki-script-msg' ).escaped(),
268 '&lt;script &gt;alert( "Who put this script here?" );&lt;/script&gt;',
269 'Script escaped when using escaped format'
270 );
271 assert.htmlEqual(
272 mw.message( 'mediawiki-script-msg' ).parse(),
273 '&lt;script &gt;alert( "Who put this script here?" );&lt;/script&gt;',
274 'Script escaped when using parse format'
275 );
276
277 } );
278
279 QUnit.test( 'mw.msg', 14, function ( assert ) {
280 assert.ok( mw.messages.set( 'hello', 'Hello <b>awesome</b> world' ), 'mw.messages.set: Register' );
281 assert.equal( mw.msg( 'hello' ), 'Hello <b>awesome</b> world', 'Gets message with default options (existing message)' );
282 assert.equal( mw.msg( 'goodbye' ), '<goodbye>', 'Gets message with default options (nonexistent message)' );
283
284 assert.ok( mw.messages.set( 'plural-item', 'Found $1 {{PLURAL:$1|item|items}}' ), 'mw.messages.set: Register' );
285 assert.equal( mw.msg( 'plural-item', 5 ), 'Found 5 items', 'Apply plural for count 5' );
286 assert.equal( mw.msg( 'plural-item', 0 ), 'Found 0 items', 'Apply plural for count 0' );
287 assert.equal( mw.msg( 'plural-item', 1 ), 'Found 1 item', 'Apply plural for count 1' );
288
289 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' );
290
291 assert.equal( mw.msg( 'gender-plural-msg', 'male', 1 ), 'he is awesome', 'Gender test for male, plural count 1' );
292 assert.equal( mw.msg( 'gender-plural-msg', 'female', '1' ), 'she is awesome', 'Gender test for female, plural count 1' );
293 assert.equal( mw.msg( 'gender-plural-msg', 'unknown', 10 ), 'they are awesome', 'Gender test for neutral, plural count 10' );
294
295 assert.equal( mw.msg( 'grammar-msg' ), 'Przeszukaj ' + mw.config.get( 'wgSiteName' ), 'Grammar is resolved' );
296
297 assert.equal( mw.msg( 'formatnum-msg', '987654321.654321' ), '987,654,321.654', 'formatnum is resolved' );
298
299 assert.equal( mw.msg( 'int-msg' ), 'Some Other Message', 'int is resolved' );
300 } );
301
302 /**
303 * The sync style load test (for @import). This is, in a way, also an open bug for
304 * ResourceLoader ("execute js after styles are loaded"), but browsers don't offer a
305 * way to get a callback from when a stylesheet is loaded (that is, including any
306 * @import rules inside). To work around this, we'll have a little time loop to check
307 * if the styles apply.
308 * Note: This test originally used new Image() and onerror to get a callback
309 * when the url is loaded, but that is fragile since it doesn't monitor the
310 * same request as the css @import, and Safari 4 has issues with
311 * onerror/onload not being fired at all in weird cases like this.
312 */
313 function assertStyleAsync( assert, $element, prop, val, fn ) {
314 var styleTestStart,
315 el = $element.get( 0 ),
316 styleTestTimeout = ( QUnit.config.testTimeout || 5000 ) - 200;
317
318 function isCssImportApplied() {
319 // Trigger reflow, repaint, redraw, whatever (cross-browser)
320 var x = $element.css( 'height' );
321 x = el.innerHTML;
322 el.className = el.className;
323 x = document.documentElement.clientHeight;
324
325 return $element.css( prop ) === val;
326 }
327
328 function styleTestLoop() {
329 var styleTestSince = new Date().getTime() - styleTestStart;
330 // If it is passing or if we timed out, run the real test and stop the loop
331 if ( isCssImportApplied() || styleTestSince > styleTestTimeout ) {
332 assert.equal( $element.css( prop ), val,
333 'style "' + prop + ': ' + val + '" from url is applied (after ' + styleTestSince + 'ms)'
334 );
335
336 if ( fn ) {
337 fn();
338 }
339
340 return;
341 }
342 // Otherwise, keep polling
343 setTimeout( styleTestLoop, 150 );
344 }
345
346 // Start the loop
347 styleTestStart = new Date().getTime();
348 styleTestLoop();
349 }
350
351 function urlStyleTest( selector, prop, val ) {
352 return QUnit.fixurl(
353 mw.config.get( 'wgScriptPath' ) +
354 '/tests/qunit/data/styleTest.css.php?' +
355 $.param( {
356 selector: selector,
357 prop: prop,
358 val: val
359 } )
360 );
361 }
362
363 QUnit.asyncTest( 'mw.loader', 2, function ( assert ) {
364 var isAwesomeDone;
365
366 mw.loader.testCallback = function () {
367 QUnit.start();
368 assert.strictEqual( isAwesomeDone, undefined, 'Implementing module is.awesome: isAwesomeDone should still be undefined' );
369 isAwesomeDone = true;
370 };
371
372 mw.loader.implement( 'test.callback', [QUnit.fixurl( mw.config.get( 'wgScriptPath' ) + '/tests/qunit/data/callMwLoaderTestCallback.js' )], {}, {} );
373
374 mw.loader.using( 'test.callback', function () {
375
376 // /sample/awesome.js declares the "mw.loader.testCallback" function
377 // which contains a call to start() and ok()
378 assert.strictEqual( isAwesomeDone, true, 'test.callback module should\'ve caused isAwesomeDone to be true' );
379 delete mw.loader.testCallback;
380
381 }, function () {
382 QUnit.start();
383 assert.ok( false, 'Error callback fired while loader.using "test.callback" module' );
384 } );
385 } );
386
387 QUnit.asyncTest( 'mw.loader.using( .. ).promise', 2, function ( assert ) {
388 var isAwesomeDone;
389
390 mw.loader.testCallback = function () {
391 QUnit.start();
392 assert.strictEqual( isAwesomeDone, undefined, 'Implementing module is.awesome: isAwesomeDone should still be undefined' );
393 isAwesomeDone = true;
394 };
395
396 mw.loader.implement( 'test.promise', [QUnit.fixurl( mw.config.get( 'wgScriptPath' ) + '/tests/qunit/data/callMwLoaderTestCallback.js' )], {}, {} );
397
398 mw.loader.using( 'test.promise' )
399 .done( function () {
400
401 // /sample/awesome.js declares the "mw.loader.testCallback" function
402 // which contains a call to start() and ok()
403 assert.strictEqual( isAwesomeDone, true, 'test.promise module should\'ve caused isAwesomeDone to be true' );
404 delete mw.loader.testCallback;
405
406 } )
407 .fail( function () {
408 QUnit.start();
409 assert.ok( false, 'Error callback fired while loader.using "test.promise" module' );
410 } );
411 } );
412
413 QUnit.asyncTest( 'mw.loader.implement( styles={ "css": [text, ..] } )', 2, function ( assert ) {
414 var $element = $( '<div class="mw-test-implement-a"></div>' ).appendTo( '#qunit-fixture' );
415
416 assert.notEqual(
417 $element.css( 'float' ),
418 'right',
419 'style is clear'
420 );
421
422 mw.loader.implement(
423 'test.implement.a',
424 function () {
425 assert.equal(
426 $element.css( 'float' ),
427 'right',
428 'style is applied'
429 );
430 QUnit.start();
431 },
432 {
433 'all': '.mw-test-implement-a { float: right; }'
434 },
435 {}
436 );
437
438 mw.loader.load( [
439 'test.implement.a'
440 ] );
441 } );
442
443 QUnit.asyncTest( 'mw.loader.implement( styles={ "url": { <media>: [url, ..] } } )', 7, function ( assert ) {
444 var $element1 = $( '<div class="mw-test-implement-b1"></div>' ).appendTo( '#qunit-fixture' ),
445 $element2 = $( '<div class="mw-test-implement-b2"></div>' ).appendTo( '#qunit-fixture' ),
446 $element3 = $( '<div class="mw-test-implement-b3"></div>' ).appendTo( '#qunit-fixture' );
447
448 assert.notEqual(
449 $element1.css( 'text-align' ),
450 'center',
451 'style is clear'
452 );
453 assert.notEqual(
454 $element2.css( 'float' ),
455 'left',
456 'style is clear'
457 );
458 assert.notEqual(
459 $element3.css( 'text-align' ),
460 'right',
461 'style is clear'
462 );
463
464 mw.loader.implement(
465 'test.implement.b',
466 function () {
467 // Note: QUnit.start() must only be called when the entire test is
468 // complete. So, make sure that we don't start until *both*
469 // assertStyleAsync calls have completed.
470 var pending = 2;
471 assertStyleAsync( assert, $element2, 'float', 'left', function () {
472 assert.notEqual( $element1.css( 'text-align' ), 'center', 'print style is not applied' );
473
474 pending--;
475 if ( pending === 0 ) {
476 QUnit.start();
477 }
478 } );
479 assertStyleAsync( assert, $element3, 'float', 'right', function () {
480 assert.notEqual( $element1.css( 'text-align' ), 'center', 'print style is not applied' );
481
482 pending--;
483 if ( pending === 0 ) {
484 QUnit.start();
485 }
486 } );
487 },
488 {
489 'url': {
490 'print': [urlStyleTest( '.mw-test-implement-b1', 'text-align', 'center' )],
491 'screen': [
492 // bug 40834: Make sure it actually works with more than 1 stylesheet reference
493 urlStyleTest( '.mw-test-implement-b2', 'float', 'left' ),
494 urlStyleTest( '.mw-test-implement-b3', 'float', 'right' )
495 ]
496 }
497 },
498 {}
499 );
500
501 mw.loader.load( [
502 'test.implement.b'
503 ] );
504 } );
505
506 // Backwards compatibility
507 QUnit.asyncTest( 'mw.loader.implement( styles={ <media>: text } ) (back-compat)', 2, function ( assert ) {
508 var $element = $( '<div class="mw-test-implement-c"></div>' ).appendTo( '#qunit-fixture' );
509
510 assert.notEqual(
511 $element.css( 'float' ),
512 'right',
513 'style is clear'
514 );
515
516 mw.loader.implement(
517 'test.implement.c',
518 function () {
519 assert.equal(
520 $element.css( 'float' ),
521 'right',
522 'style is applied'
523 );
524 QUnit.start();
525 },
526 {
527 'all': '.mw-test-implement-c { float: right; }'
528 },
529 {}
530 );
531
532 mw.loader.load( [
533 'test.implement.c'
534 ] );
535 } );
536
537 // Backwards compatibility
538 QUnit.asyncTest( 'mw.loader.implement( styles={ <media>: [url, ..] } ) (back-compat)', 4, function ( assert ) {
539 var $element = $( '<div class="mw-test-implement-d"></div>' ).appendTo( '#qunit-fixture' ),
540 $element2 = $( '<div class="mw-test-implement-d2"></div>' ).appendTo( '#qunit-fixture' );
541
542 assert.notEqual(
543 $element.css( 'float' ),
544 'right',
545 'style is clear'
546 );
547 assert.notEqual(
548 $element2.css( 'text-align' ),
549 'center',
550 'style is clear'
551 );
552
553 mw.loader.implement(
554 'test.implement.d',
555 function () {
556 assertStyleAsync( assert, $element, 'float', 'right', function () {
557
558 assert.notEqual( $element2.css( 'text-align' ), 'center', 'print style is not applied (bug 40500)' );
559
560 QUnit.start();
561 } );
562 },
563 {
564 'all': [urlStyleTest( '.mw-test-implement-d', 'float', 'right' )],
565 'print': [urlStyleTest( '.mw-test-implement-d2', 'text-align', 'center' )]
566 },
567 {}
568 );
569
570 mw.loader.load( [
571 'test.implement.d'
572 ] );
573 } );
574
575 // @import (bug 31676)
576 QUnit.asyncTest( 'mw.loader.implement( styles has @import)', 5, function ( assert ) {
577 var isJsExecuted, $element;
578
579 mw.loader.implement(
580 'test.implement.import',
581 function () {
582 assert.strictEqual( isJsExecuted, undefined, 'javascript not executed multiple times' );
583 isJsExecuted = true;
584
585 assert.equal( mw.loader.getState( 'test.implement.import' ), 'ready', 'module state is "ready" while implement() is executing javascript' );
586
587 $element = $( '<div class="mw-test-implement-import">Foo bar</div>' ).appendTo( '#qunit-fixture' );
588
589 assert.equal( mw.msg( 'test-foobar' ), 'Hello Foobar, $1!', 'Messages are loaded before javascript execution' );
590
591 assertStyleAsync( assert, $element, 'float', 'right', function () {
592 assert.equal( $element.css( 'text-align' ), 'center',
593 'CSS styles after the @import rule are working'
594 );
595
596 QUnit.start();
597 } );
598 },
599 {
600 'css': [
601 '@import url(\''
602 + urlStyleTest( '.mw-test-implement-import', 'float', 'right' )
603 + '\');\n'
604 + '.mw-test-implement-import { text-align: center; }'
605 ]
606 },
607 {
608 'test-foobar': 'Hello Foobar, $1!'
609 }
610 );
611
612 mw.loader.load( 'test.implement' );
613
614 } );
615
616 QUnit.asyncTest( 'mw.loader.implement( only messages )', 2, function ( assert ) {
617 assert.assertFalse( mw.messages.exists( 'bug_29107' ), 'Verify that the test message doesn\'t exist yet' );
618
619 mw.loader.implement( 'test.implement.msgs', [], {}, { 'bug_29107': 'loaded' } );
620 mw.loader.using( 'test.implement.msgs', function () {
621 QUnit.start();
622 assert.ok( mw.messages.exists( 'bug_29107' ), 'Bug 29107: messages-only module should implement ok' );
623 }, function () {
624 QUnit.start();
625 assert.ok( false, 'Error callback fired while implementing "test.implement.msgs" module' );
626 } );
627 } );
628
629 QUnit.test( 'mw.loader erroneous indirect dependency', 3, function ( assert ) {
630 mw.loader.register( [
631 ['test.module1', '0'],
632 ['test.module2', '0', ['test.module1']],
633 ['test.module3', '0', ['test.module2']]
634 ] );
635 mw.loader.implement( 'test.module1', function () {
636 throw new Error( 'expected' );
637 }, {}, {} );
638 assert.strictEqual( mw.loader.getState( 'test.module1' ), 'error', 'Expected "error" state for test.module1' );
639 assert.strictEqual( mw.loader.getState( 'test.module2' ), 'error', 'Expected "error" state for test.module2' );
640 assert.strictEqual( mw.loader.getState( 'test.module3' ), 'error', 'Expected "error" state for test.module3' );
641 } );
642
643 QUnit.test( 'mw.loader out-of-order implementation', 9, function ( assert ) {
644 mw.loader.register( [
645 ['test.module4', '0'],
646 ['test.module5', '0', ['test.module4']],
647 ['test.module6', '0', ['test.module5']]
648 ] );
649 mw.loader.implement( 'test.module4', function () {
650 }, {}, {} );
651 assert.strictEqual( mw.loader.getState( 'test.module4' ), 'ready', 'Expected "ready" state for test.module4' );
652 assert.strictEqual( mw.loader.getState( 'test.module5' ), 'registered', 'Expected "registered" state for test.module5' );
653 assert.strictEqual( mw.loader.getState( 'test.module6' ), 'registered', 'Expected "registered" state for test.module6' );
654 mw.loader.implement( 'test.module6', function () {
655 }, {}, {} );
656 assert.strictEqual( mw.loader.getState( 'test.module4' ), 'ready', 'Expected "ready" state for test.module4' );
657 assert.strictEqual( mw.loader.getState( 'test.module5' ), 'registered', 'Expected "registered" state for test.module5' );
658 assert.strictEqual( mw.loader.getState( 'test.module6' ), 'loaded', 'Expected "loaded" state for test.module6' );
659 mw.loader.implement( 'test.module5', function () {
660 }, {}, {} );
661 assert.strictEqual( mw.loader.getState( 'test.module4' ), 'ready', 'Expected "ready" state for test.module4' );
662 assert.strictEqual( mw.loader.getState( 'test.module5' ), 'ready', 'Expected "ready" state for test.module5' );
663 assert.strictEqual( mw.loader.getState( 'test.module6' ), 'ready', 'Expected "ready" state for test.module6' );
664 } );
665
666 QUnit.test( 'mw.loader missing dependency', 13, function ( assert ) {
667 mw.loader.register( [
668 ['test.module7', '0'],
669 ['test.module8', '0', ['test.module7']],
670 ['test.module9', '0', ['test.module8']]
671 ] );
672 mw.loader.implement( 'test.module8', function () {
673 }, {}, {} );
674 assert.strictEqual( mw.loader.getState( 'test.module7' ), 'registered', 'Expected "registered" state for test.module7' );
675 assert.strictEqual( mw.loader.getState( 'test.module8' ), 'loaded', 'Expected "loaded" state for test.module8' );
676 assert.strictEqual( mw.loader.getState( 'test.module9' ), 'registered', 'Expected "registered" state for test.module9' );
677 mw.loader.state( 'test.module7', 'missing' );
678 assert.strictEqual( mw.loader.getState( 'test.module7' ), 'missing', 'Expected "missing" state for test.module7' );
679 assert.strictEqual( mw.loader.getState( 'test.module8' ), 'error', 'Expected "error" state for test.module8' );
680 assert.strictEqual( mw.loader.getState( 'test.module9' ), 'error', 'Expected "error" state for test.module9' );
681 mw.loader.implement( 'test.module9', function () {
682 }, {}, {} );
683 assert.strictEqual( mw.loader.getState( 'test.module7' ), 'missing', 'Expected "missing" state for test.module7' );
684 assert.strictEqual( mw.loader.getState( 'test.module8' ), 'error', 'Expected "error" state for test.module8' );
685 assert.strictEqual( mw.loader.getState( 'test.module9' ), 'error', 'Expected "error" state for test.module9' );
686 mw.loader.using(
687 ['test.module7'],
688 function () {
689 assert.ok( false, 'Success fired despite missing dependency' );
690 assert.ok( true, 'QUnit expected() count dummy' );
691 },
692 function ( e, dependencies ) {
693 assert.strictEqual( $.isArray( dependencies ), true, 'Expected array of dependencies' );
694 assert.deepEqual( dependencies, ['test.module7'], 'Error callback called with module test.module7' );
695 }
696 );
697 mw.loader.using(
698 ['test.module9'],
699 function () {
700 assert.ok( false, 'Success fired despite missing dependency' );
701 assert.ok( true, 'QUnit expected() count dummy' );
702 },
703 function ( e, dependencies ) {
704 assert.strictEqual( $.isArray( dependencies ), true, 'Expected array of dependencies' );
705 dependencies.sort();
706 assert.deepEqual(
707 dependencies,
708 ['test.module7', 'test.module8', 'test.module9'],
709 'Error callback called with all three modules as dependencies'
710 );
711 }
712 );
713 } );
714
715 QUnit.asyncTest( 'mw.loader dependency handling', 5, function ( assert ) {
716 mw.loader.addSource(
717 'testloader',
718 {
719 loadScript: QUnit.fixurl( mw.config.get( 'wgScriptPath' ) + '/tests/qunit/data/load.mock.php' )
720 }
721 );
722
723 mw.loader.register( [
724 // [module, version, dependencies, group, source]
725 ['testMissing', '1', [], null, 'testloader'],
726 ['testUsesMissing', '1', ['testMissing'], null, 'testloader'],
727 ['testUsesNestedMissing', '1', ['testUsesMissing'], null, 'testloader']
728 ] );
729
730 function verifyModuleStates() {
731 assert.equal( mw.loader.getState( 'testMissing' ), 'missing', 'Module not known to server must have state "missing"' );
732 assert.equal( mw.loader.getState( 'testUsesMissing' ), 'error', 'Module with missing dependency must have state "error"' );
733 assert.equal( mw.loader.getState( 'testUsesNestedMissing' ), 'error', 'Module with indirect missing dependency must have state "error"' );
734 }
735
736 mw.loader.using( ['testUsesNestedMissing'],
737 function () {
738 assert.ok( false, 'Error handler should be invoked.' );
739 assert.ok( true ); // Dummy to reach QUnit expect()
740
741 verifyModuleStates();
742
743 QUnit.start();
744 },
745 function ( e, badmodules ) {
746 assert.ok( true, 'Error handler should be invoked.' );
747 // As soon as server spits out state('testMissing', 'missing');
748 // it will bubble up and trigger the error callback.
749 // Therefor the badmodules array is not testUsesMissing or testUsesNestedMissing.
750 assert.deepEqual( badmodules, ['testMissing'], 'Bad modules as expected.' );
751
752 verifyModuleStates();
753
754 QUnit.start();
755 }
756 );
757 } );
758
759 QUnit.asyncTest( 'mw.loader( "//protocol-relative" ) (bug 30825)', 2, function ( assert ) {
760 // This bug was actually already fixed in 1.18 and later when discovered in 1.17.
761 // Test is for regressions!
762
763 // Forge an URL to the test callback script
764 var target = QUnit.fixurl(
765 mw.config.get( 'wgServer' ) + mw.config.get( 'wgScriptPath' ) + '/tests/qunit/data/qunitOkCall.js'
766 );
767
768 // Confirm that mw.loader.load() works with protocol-relative URLs
769 target = target.replace( /https?:/, '' );
770
771 assert.equal( target.substr( 0, 2 ), '//',
772 'URL must be relative to test relative URLs!'
773 );
774
775 // Async!
776 // The target calls QUnit.start
777 mw.loader.load( target );
778 } );
779
780 QUnit.test( 'mw.html', 13, function ( assert ) {
781 assert.throws( function () {
782 mw.html.escape();
783 }, TypeError, 'html.escape throws a TypeError if argument given is not a string' );
784
785 assert.equal( mw.html.escape( '<mw awesome="awesome" value=\'test\' />' ),
786 '&lt;mw awesome=&quot;awesome&quot; value=&#039;test&#039; /&gt;', 'escape() escapes special characters to html entities' );
787
788 assert.equal( mw.html.element(),
789 '<undefined/>', 'element() always returns a valid html string (even without arguments)' );
790
791 assert.equal( mw.html.element( 'div' ), '<div/>', 'element() Plain DIV (simple)' );
792
793 assert.equal( mw.html.element( 'div', {}, '' ), '<div></div>', 'element() Basic DIV (simple)' );
794
795 assert.equal(
796 mw.html.element(
797 'div', {
798 id: 'foobar'
799 }
800 ),
801 '<div id="foobar"/>',
802 'html.element DIV (attribs)' );
803
804 assert.equal( mw.html.element( 'p', null, 12 ), '<p>12</p>', 'Numbers are valid content and should be casted to a string' );
805
806 assert.equal( mw.html.element( 'p', { title: 12 }, '' ), '<p title="12"></p>', 'Numbers are valid attribute values' );
807
808 // Example from https://www.mediawiki.org/wiki/ResourceLoader/Default_modules#mediaWiki.html
809 assert.equal(
810 mw.html.element(
811 'div',
812 {},
813 new mw.html.Raw(
814 mw.html.element( 'img', { src: '<' } )
815 )
816 ),
817 '<div><img src="&lt;"/></div>',
818 'Raw inclusion of another element'
819 );
820
821 assert.equal(
822 mw.html.element(
823 'option', {
824 selected: true
825 }, 'Foo'
826 ),
827 '<option selected="selected">Foo</option>',
828 'Attributes may have boolean values. True copies the attribute name to the value.'
829 );
830
831 assert.equal(
832 mw.html.element(
833 'option', {
834 value: 'foo',
835 selected: false
836 }, 'Foo'
837 ),
838 '<option value="foo">Foo</option>',
839 'Attributes may have boolean values. False keeps the attribute from output.'
840 );
841
842 assert.equal( mw.html.element( 'div',
843 null, 'a' ),
844 '<div>a</div>',
845 'html.element DIV (content)' );
846
847 assert.equal( mw.html.element( 'a',
848 { href: 'http://mediawiki.org/w/index.php?title=RL&action=history' }, 'a' ),
849 '<a href="http://mediawiki.org/w/index.php?title=RL&amp;action=history">a</a>',
850 'html.element DIV (attribs + content)' );
851
852 } );
853
854 QUnit.test( 'mw.hook', 10, function ( assert ) {
855 var hook, add, fire, chars, callback;
856
857 mw.hook( 'test.hook.unfired' ).add( function () {
858 assert.ok( false, 'Unfired hook' );
859 } );
860
861 mw.hook( 'test.hook.basic' ).add( function () {
862 assert.ok( true, 'Basic callback' );
863 } );
864 mw.hook( 'test.hook.basic' ).fire();
865
866 mw.hook( 'test.hook.data' ).add( function ( data1, data2 ) {
867 assert.equal( data1, 'example', 'Fire with data (string param)' );
868 assert.deepEqual( data2, ['two'], 'Fire with data (array param)' );
869 } );
870 mw.hook( 'test.hook.data' ).fire( 'example', ['two'] );
871
872 mw.hook( 'test.hook.chainable' ).add( function () {
873 assert.ok( true, 'Chainable' );
874 } ).fire();
875
876 hook = mw.hook( 'test.hook.detach' );
877 add = hook.add;
878 fire = hook.fire;
879 add( function ( x, y ) {
880 assert.deepEqual( [x, y], ['x', 'y'], 'Detached (contextless) with data' );
881 } );
882 fire( 'x', 'y' );
883
884 mw.hook( 'test.hook.fireBefore' ).fire().add( function () {
885 assert.ok( true, 'Invoke handler right away if it was fired before' );
886 } );
887
888 mw.hook( 'test.hook.fireTwiceBefore' ).fire().fire().add( function () {
889 assert.ok( true, 'Invoke handler right away if it was fired before (only last one)' );
890 } );
891
892 chars = [];
893
894 mw.hook( 'test.hook.many' )
895 .add( function ( chr ) {
896 chars.push( chr );
897 } )
898 .fire( 'x' ).fire( 'y' ).fire( 'z' )
899 .add( function ( chr ) {
900 assert.equal( chr, 'z', 'Adding callback later invokes right away with last data' );
901 } );
902
903 assert.deepEqual( chars, ['x', 'y', 'z'], 'Multiple callbacks with multiple fires' );
904
905 chars = [];
906 callback = function ( chr ) {
907 chars.push( chr );
908 };
909
910 mw.hook( 'test.hook.variadic' )
911 .add(
912 callback,
913 callback,
914 function ( chr ) {
915 chars.push( chr );
916 },
917 callback
918 )
919 .fire( 'x' )
920 .remove(
921 function () {
922 'not-added';
923 },
924 callback
925 )
926 .fire( 'y' )
927 .remove( callback )
928 .fire( 'z' );
929
930 assert.deepEqual(
931 chars,
932 ['x', 'x', 'x', 'x', 'y', 'z'],
933 '"add" and "remove" support variadic arguments. ' +
934 '"add" does not filter unique. ' +
935 '"remove" removes all equal by reference. ' +
936 '"remove" is silent if the function is not found'
937 );
938 } );
939
940 }( mediaWiki, jQuery ) );