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