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