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.asyncTest( 'mw.loader', 2, function ( assert ) {
 415                 var isAwesomeDone;
 416
 417                 mw.loader.testCallback = function () {
 418                         QUnit.start();
 419                         assert.strictEqual( isAwesomeDone, undefined, 'Implementing module is.awesome: isAwesomeDone should still be undefined' );
 420                         isAwesomeDone = true;
 421                 };
 422
 423                 mw.loader.implement( 'test.callback', [ QUnit.fixurl( mw.config.get( 'wgScriptPath' ) + '/tests/qunit/data/callMwLoaderTestCallback.js' ) ] );
 424
 425                 mw.loader.using( 'test.callback', function () {
 426
 427                         // /sample/awesome.js declares the "mw.loader.testCallback" function
 428                         // which contains a call to start() and ok()
 429                         assert.strictEqual( isAwesomeDone, true, 'test.callback module should\'ve caused isAwesomeDone to be true' );
 430                         delete mw.loader.testCallback;
 431
 432                 }, function () {
 433                         QUnit.start();
 434                         assert.ok( false, 'Error callback fired while loader.using "test.callback" module' );
 435                 } );
 436         } );
 437
 438         QUnit.asyncTest( 'mw.loader with Object method as module name', 2, function ( assert ) {
 439                 var isAwesomeDone;
 440
 441                 mw.loader.testCallback = function () {
 442                         QUnit.start();
 443                         assert.strictEqual( isAwesomeDone, undefined, 'Implementing module hasOwnProperty: isAwesomeDone should still be undefined' );
 444                         isAwesomeDone = true;
 445                 };
 446
 447                 mw.loader.implement( 'hasOwnProperty', [ QUnit.fixurl( mw.config.get( 'wgScriptPath' ) + '/tests/qunit/data/callMwLoaderTestCallback.js' ) ], {}, {} );
 448
 449                 mw.loader.using( 'hasOwnProperty', function () {
 450
 451                         // /sample/awesome.js declares the "mw.loader.testCallback" function
 452                         // which contains a call to start() and ok()
 453                         assert.strictEqual( isAwesomeDone, true, 'hasOwnProperty module should\'ve caused isAwesomeDone to be true' );
 454                         delete mw.loader.testCallback;
 455
 456                 }, function () {
 457                         QUnit.start();
 458                         assert.ok( false, 'Error callback fired while loader.using "hasOwnProperty" module' );
 459                 } );
 460         } );
 461
 462         QUnit.asyncTest( 'mw.loader.using( .. ) Promise', 2, function ( assert ) {
 463                 var isAwesomeDone;
 464
 465                 mw.loader.testCallback = function () {
 466                         QUnit.start();
 467                         assert.strictEqual( isAwesomeDone, undefined, 'Implementing module is.awesome: isAwesomeDone should still be undefined' );
 468                         isAwesomeDone = true;
 469                 };
 470
 471                 mw.loader.implement( 'test.promise', [ QUnit.fixurl( mw.config.get( 'wgScriptPath' ) + '/tests/qunit/data/callMwLoaderTestCallback.js' ) ] );
 472
 473                 mw.loader.using( 'test.promise' )
 474                 .done( function () {
 475
 476                         // /sample/awesome.js declares the "mw.loader.testCallback" function
 477                         // which contains a call to start() and ok()
 478                         assert.strictEqual( isAwesomeDone, true, 'test.promise module should\'ve caused isAwesomeDone to be true' );
 479                         delete mw.loader.testCallback;
 480
 481                 } )
 482                 .fail( function () {
 483                         QUnit.start();
 484                         assert.ok( false, 'Error callback fired while loader.using "test.promise" module' );
 485                 } );
 486         } );
 487
 488         QUnit.asyncTest( 'mw.loader.implement( styles={ "css": [text, ..] } )', 2, function ( assert ) {
 489                 var $element = $( '<div class="mw-test-implement-a"></div>' ).appendTo( '#qunit-fixture' );
 490
 491                 assert.notEqual(
 492                         $element.css( 'float' ),
 493                         'right',
 494                         'style is clear'
 495                 );
 496
 497                 mw.loader.implement(
 498                         'test.implement.a',
 499                         function () {
 500                                 assert.equal(
 501                                         $element.css( 'float' ),
 502                                         'right',
 503                                         'style is applied'
 504                                 );
 505                                 QUnit.start();
 506                         },
 507                         {
 508                                 all: '.mw-test-implement-a { float: right; }'
 509                         }
 510                 );
 511
 512                 mw.loader.load( [
 513                         'test.implement.a'
 514                 ] );
 515         } );
 516
 517         QUnit.asyncTest( 'mw.loader.implement( styles={ "url": { <media>: [url, ..] } } )', 7, function ( assert ) {
 518                 var $element1 = $( '<div class="mw-test-implement-b1"></div>' ).appendTo( '#qunit-fixture' ),
 519                         $element2 = $( '<div class="mw-test-implement-b2"></div>' ).appendTo( '#qunit-fixture' ),
 520                         $element3 = $( '<div class="mw-test-implement-b3"></div>' ).appendTo( '#qunit-fixture' );
 521
 522                 assert.notEqual(
 523                         $element1.css( 'text-align' ),
 524                         'center',
 525                         'style is clear'
 526                 );
 527                 assert.notEqual(
 528                         $element2.css( 'float' ),
 529                         'left',
 530                         'style is clear'
 531                 );
 532                 assert.notEqual(
 533                         $element3.css( 'text-align' ),
 534                         'right',
 535                         'style is clear'
 536                 );
 537
 538                 mw.loader.implement(
 539                         'test.implement.b',
 540                         function () {
 541                                 // Note: QUnit.start() must only be called when the entire test is
 542                                 // complete. So, make sure that we don't start until *both*
 543                                 // assertStyleAsync calls have completed.
 544                                 var pending = 2;
 545                                 assertStyleAsync( assert, $element2, 'float', 'left', function () {
 546                                         assert.notEqual( $element1.css( 'text-align' ), 'center', 'print style is not applied' );
 547
 548                                         pending--;
 549                                         if ( pending === 0 ) {
 550                                                 QUnit.start();
 551                                         }
 552                                 } );
 553                                 assertStyleAsync( assert, $element3, 'float', 'right', function () {
 554                                         assert.notEqual( $element1.css( 'text-align' ), 'center', 'print style is not applied' );
 555
 556                                         pending--;
 557                                         if ( pending === 0 ) {
 558                                                 QUnit.start();
 559                                         }
 560                                 } );
 561                         },
 562                         {
 563                                 url: {
 564                                         print: [ urlStyleTest( '.mw-test-implement-b1', 'text-align', 'center' ) ],
 565                                         screen: [
 566                                                 // bug 40834: Make sure it actually works with more than 1 stylesheet reference
 567                                                 urlStyleTest( '.mw-test-implement-b2', 'float', 'left' ),
 568                                                 urlStyleTest( '.mw-test-implement-b3', 'float', 'right' )
 569                                         ]
 570                                 }
 571                         }
 572                 );
 573
 574                 mw.loader.load( [
 575                         'test.implement.b'
 576                 ] );
 577         } );
 578
 579         // Backwards compatibility
 580         QUnit.asyncTest( 'mw.loader.implement( styles={ <media>: text } ) (back-compat)', 2, function ( assert ) {
 581                 var $element = $( '<div class="mw-test-implement-c"></div>' ).appendTo( '#qunit-fixture' );
 582
 583                 assert.notEqual(
 584                         $element.css( 'float' ),
 585                         'right',
 586                         'style is clear'
 587                 );
 588
 589                 mw.loader.implement(
 590                         'test.implement.c',
 591                         function () {
 592                                 assert.equal(
 593                                         $element.css( 'float' ),
 594                                         'right',
 595                                         'style is applied'
 596                                 );
 597                                 QUnit.start();
 598                         },
 599                         {
 600                                 all: '.mw-test-implement-c { float: right; }'
 601                         }
 602                 );
 603
 604                 mw.loader.load( [
 605                         'test.implement.c'
 606                 ] );
 607         } );
 608
 609         // Backwards compatibility
 610         QUnit.asyncTest( 'mw.loader.implement( styles={ <media>: [url, ..] } ) (back-compat)', 4, function ( assert ) {
 611                 var $element = $( '<div class="mw-test-implement-d"></div>' ).appendTo( '#qunit-fixture' ),
 612                         $element2 = $( '<div class="mw-test-implement-d2"></div>' ).appendTo( '#qunit-fixture' );
 613
 614                 assert.notEqual(
 615                         $element.css( 'float' ),
 616                         'right',
 617                         'style is clear'
 618                 );
 619                 assert.notEqual(
 620                         $element2.css( 'text-align' ),
 621                         'center',
 622                         'style is clear'
 623                 );
 624
 625                 mw.loader.implement(
 626                         'test.implement.d',
 627                         function () {
 628                                 assertStyleAsync( assert, $element, 'float', 'right', function () {
 629
 630                                         assert.notEqual( $element2.css( 'text-align' ), 'center', 'print style is not applied (bug 40500)' );
 631
 632                                         QUnit.start();
 633                                 } );
 634                         },
 635                         {
 636                                 all: [ urlStyleTest( '.mw-test-implement-d', 'float', 'right' ) ],
 637                                 print: [ urlStyleTest( '.mw-test-implement-d2', 'text-align', 'center' ) ]
 638                         }
 639                 );
 640
 641                 mw.loader.load( [
 642                         'test.implement.d'
 643                 ] );
 644         } );
 645
 646         // @import (bug 31676)
 647         QUnit.asyncTest( 'mw.loader.implement( styles has @import )', 7, function ( assert ) {
 648                 var isJsExecuted, $element;
 649
 650                 mw.loader.implement(
 651                         'test.implement.import',
 652                         function () {
 653                                 assert.strictEqual( isJsExecuted, undefined, 'script not executed multiple times' );
 654                                 isJsExecuted = true;
 655
 656                                 assert.equal( mw.loader.getState( 'test.implement.import' ), 'executing', 'module state during implement() script execution' );
 657
 658                                 $element = $( '<div class="mw-test-implement-import">Foo bar</div>' ).appendTo( '#qunit-fixture' );
 659
 660                                 assert.equal( mw.msg( 'test-foobar' ), 'Hello Foobar, $1!', 'messages load before script execution' );
 661
 662                                 assertStyleAsync( assert, $element, 'float', 'right', function () {
 663                                         assert.equal( $element.css( 'text-align' ), 'center',
 664                                                 'CSS styles after the @import rule are working'
 665                                         );
 666
 667                                         QUnit.start();
 668                                 } );
 669                         },
 670                         {
 671                                 css: [
 672                                         '@import url(\''
 673                                                 + urlStyleTest( '.mw-test-implement-import', 'float', 'right' )
 674                                                 + '\');\n'
 675                                                 + '.mw-test-implement-import { text-align: center; }'
 676                                 ]
 677                         },
 678                         {
 679                                 'test-foobar': 'Hello Foobar, $1!'
 680                         }
 681                 );
 682
 683                 mw.loader.using( 'test.implement.import' ).always( function () {
 684                         assert.strictEqual( isJsExecuted, true, 'script executed' );
 685                         assert.equal( mw.loader.getState( 'test.implement.import' ), 'ready', 'module state after script execution' );
 686                 } );
 687         } );
 688
 689         QUnit.asyncTest( 'mw.loader.implement( dependency with styles )', 4, function ( assert ) {
 690                 var $element = $( '<div class="mw-test-implement-e"></div>' ).appendTo( '#qunit-fixture' ),
 691                         $element2 = $( '<div class="mw-test-implement-e2"></div>' ).appendTo( '#qunit-fixture' );
 692
 693                 assert.notEqual(
 694                         $element.css( 'float' ),
 695                         'right',
 696                         'style is clear'
 697                 );
 698                 assert.notEqual(
 699                         $element2.css( 'float' ),
 700                         'left',
 701                         'style is clear'
 702                 );
 703
 704                 mw.loader.register( [
 705                         [ 'test.implement.e', '0', [ 'test.implement.e2' ] ],
 706                         [ 'test.implement.e2', '0' ]
 707                 ] );
 708
 709                 mw.loader.implement(
 710                         'test.implement.e',
 711                         function () {
 712                                 assert.equal(
 713                                         $element.css( 'float' ),
 714                                         'right',
 715                                         'Depending module\'s style is applied'
 716                                 );
 717                                 QUnit.start();
 718                         },
 719                         {
 720                                 all: '.mw-test-implement-e { float: right; }'
 721                         }
 722                 );
 723
 724                 mw.loader.implement(
 725                         'test.implement.e2',
 726                         function () {
 727                                 assert.equal(
 728                                         $element2.css( 'float' ),
 729                                         'left',
 730                                         'Dependency\'s style is applied'
 731                                 );
 732                         },
 733                         {
 734                                 all: '.mw-test-implement-e2 { float: left; }'
 735                         }
 736                 );
 737
 738                 mw.loader.load( [
 739                         'test.implement.e'
 740                 ] );
 741         } );
 742
 743         QUnit.test( 'mw.loader.implement( only scripts )', 1, function ( assert ) {
 744                 mw.loader.implement( 'test.onlyscripts', function () {} );
 745                 assert.strictEqual( mw.loader.getState( 'test.onlyscripts' ), 'ready' );
 746         } );
 747
 748         QUnit.asyncTest( 'mw.loader.implement( only messages )', 2, function ( assert ) {
 749                 assert.assertFalse( mw.messages.exists( 'bug_29107' ), 'Verify that the test message doesn\'t exist yet' );
 750
 751                 // jscs: disable requireCamelCaseOrUpperCaseIdentifiers
 752                 mw.loader.implement( 'test.implement.msgs', [], {}, { bug_29107: 'loaded' } );
 753                 // jscs: enable requireCamelCaseOrUpperCaseIdentifiers
 754                 mw.loader.using( 'test.implement.msgs', function () {
 755                         QUnit.start();
 756                         assert.ok( mw.messages.exists( 'bug_29107' ), 'Bug 29107: messages-only module should implement ok' );
 757                 }, function () {
 758                         QUnit.start();
 759                         assert.ok( false, 'Error callback fired while implementing "test.implement.msgs" module' );
 760                 } );
 761         } );
 762
 763         QUnit.test( 'mw.loader.implement( empty )', 1, function ( assert ) {
 764                 mw.loader.implement( 'test.empty' );
 765                 assert.strictEqual( mw.loader.getState( 'test.empty' ), 'ready' );
 766         } );
 767
 768         QUnit.test( 'mw.loader with broken indirect dependency', 4, function ( assert ) {
 769                 // don't emit an error event
 770                 this.sandbox.stub( mw, 'track' );
 771
 772                 mw.loader.register( [
 773                         [ 'test.module1', '0' ],
 774                         [ 'test.module2', '0', [ 'test.module1' ] ],
 775                         [ 'test.module3', '0', [ 'test.module2' ] ]
 776                 ] );
 777                 mw.loader.implement( 'test.module1', function () {
 778                         throw new Error( 'expected' );
 779                 }, {}, {} );
 780                 assert.strictEqual( mw.loader.getState( 'test.module1' ), 'error', 'Expected "error" state for test.module1' );
 781                 assert.strictEqual( mw.loader.getState( 'test.module2' ), 'error', 'Expected "error" state for test.module2' );
 782                 assert.strictEqual( mw.loader.getState( 'test.module3' ), 'error', 'Expected "error" state for test.module3' );
 783
 784                 assert.strictEqual( mw.track.callCount, 1 );
 785         } );
 786
 787         QUnit.test( 'mw.loader with circular dependency', 1, function ( assert ) {
 788                 mw.loader.register( [
 789                         [ 'test.circle1', '0', [ 'test.circle2' ] ],
 790                         [ 'test.circle2', '0', [ 'test.circle3' ] ],
 791                         [ 'test.circle3', '0', [ 'test.circle1' ] ]
 792                 ] );
 793                 assert.throws( function () {
 794                         mw.loader.using( 'test.circle3' );
 795                 }, /Circular/, 'Detect circular dependency' );
 796         } );
 797
 798         QUnit.test( 'mw.loader out-of-order implementation', 9, function ( assert ) {
 799                 mw.loader.register( [
 800                         [ 'test.module4', '0' ],
 801                         [ 'test.module5', '0', [ 'test.module4' ] ],
 802                         [ 'test.module6', '0', [ 'test.module5' ] ]
 803                 ] );
 804                 mw.loader.implement( 'test.module4', function () {} );
 805                 assert.strictEqual( mw.loader.getState( 'test.module4' ), 'ready', 'Expected "ready" state for test.module4' );
 806                 assert.strictEqual( mw.loader.getState( 'test.module5' ), 'registered', 'Expected "registered" state for test.module5' );
 807                 assert.strictEqual( mw.loader.getState( 'test.module6' ), 'registered', 'Expected "registered" state for test.module6' );
 808                 mw.loader.implement( 'test.module6', function () {} );
 809                 assert.strictEqual( mw.loader.getState( 'test.module4' ), 'ready', 'Expected "ready" state for test.module4' );
 810                 assert.strictEqual( mw.loader.getState( 'test.module5' ), 'registered', 'Expected "registered" state for test.module5' );
 811                 assert.strictEqual( mw.loader.getState( 'test.module6' ), 'loaded', 'Expected "loaded" state for test.module6' );
 812                 mw.loader.implement( 'test.module5', function () {} );
 813                 assert.strictEqual( mw.loader.getState( 'test.module4' ), 'ready', 'Expected "ready" state for test.module4' );
 814                 assert.strictEqual( mw.loader.getState( 'test.module5' ), 'ready', 'Expected "ready" state for test.module5' );
 815                 assert.strictEqual( mw.loader.getState( 'test.module6' ), 'ready', 'Expected "ready" state for test.module6' );
 816         } );
 817
 818         QUnit.test( 'mw.loader missing dependency', 13, function ( assert ) {
 819                 mw.loader.register( [
 820                         [ 'test.module7', '0' ],
 821                         [ 'test.module8', '0', [ 'test.module7' ] ],
 822                         [ 'test.module9', '0', [ 'test.module8' ] ]
 823                 ] );
 824                 mw.loader.implement( 'test.module8', function () {} );
 825                 assert.strictEqual( mw.loader.getState( 'test.module7' ), 'registered', 'Expected "registered" state for test.module7' );
 826                 assert.strictEqual( mw.loader.getState( 'test.module8' ), 'loaded', 'Expected "loaded" state for test.module8' );
 827                 assert.strictEqual( mw.loader.getState( 'test.module9' ), 'registered', 'Expected "registered" state for test.module9' );
 828                 mw.loader.state( 'test.module7', 'missing' );
 829                 assert.strictEqual( mw.loader.getState( 'test.module7' ), 'missing', 'Expected "missing" state for test.module7' );
 830                 assert.strictEqual( mw.loader.getState( 'test.module8' ), 'error', 'Expected "error" state for test.module8' );
 831                 assert.strictEqual( mw.loader.getState( 'test.module9' ), 'error', 'Expected "error" state for test.module9' );
 832                 mw.loader.implement( 'test.module9', function () {} );
 833                 assert.strictEqual( mw.loader.getState( 'test.module7' ), 'missing', 'Expected "missing" state for test.module7' );
 834                 assert.strictEqual( mw.loader.getState( 'test.module8' ), 'error', 'Expected "error" state for test.module8' );
 835                 assert.strictEqual( mw.loader.getState( 'test.module9' ), 'error', 'Expected "error" state for test.module9' );
 836                 mw.loader.using(
 837                         [ 'test.module7' ],
 838                         function () {
 839                                 assert.ok( false, 'Success fired despite missing dependency' );
 840                                 assert.ok( true, 'QUnit expected() count dummy' );
 841                         },
 842                         function ( e, dependencies ) {
 843                                 assert.strictEqual( $.isArray( dependencies ), true, 'Expected array of dependencies' );
 844                                 assert.deepEqual( dependencies, [ 'test.module7' ], 'Error callback called with module test.module7' );
 845                         }
 846                 );
 847                 mw.loader.using(
 848                         [ 'test.module9' ],
 849                         function () {
 850                                 assert.ok( false, 'Success fired despite missing dependency' );
 851                                 assert.ok( true, 'QUnit expected() count dummy' );
 852                         },
 853                         function ( e, dependencies ) {
 854                                 assert.strictEqual( $.isArray( dependencies ), true, 'Expected array of dependencies' );
 855                                 dependencies.sort();
 856                                 assert.deepEqual(
 857                                         dependencies,
 858                                         [ 'test.module7', 'test.module8', 'test.module9' ],
 859                                         'Error callback called with all three modules as dependencies'
 860                                 );
 861                         }
 862                 );
 863         } );
 864
 865         QUnit.asyncTest( 'mw.loader dependency handling', 5, function ( assert ) {
 866                 mw.loader.register( [
 867                         // [module, version, dependencies, group, source]
 868                         [ 'testMissing', '1', [], null, 'testloader' ],
 869                         [ 'testUsesMissing', '1', [ 'testMissing' ], null, 'testloader' ],
 870                         [ 'testUsesNestedMissing', '1', [ 'testUsesMissing' ], null, 'testloader' ]
 871                 ] );
 872
 873                 function verifyModuleStates() {
 874                         assert.equal( mw.loader.getState( 'testMissing' ), 'missing', 'Module not known to server must have state "missing"' );
 875                         assert.equal( mw.loader.getState( 'testUsesMissing' ), 'error', 'Module with missing dependency must have state "error"' );
 876                         assert.equal( mw.loader.getState( 'testUsesNestedMissing' ), 'error', 'Module with indirect missing dependency must have state "error"' );
 877                 }
 878
 879                 mw.loader.using( [ 'testUsesNestedMissing' ],
 880                         function () {
 881                                 assert.ok( false, 'Error handler should be invoked.' );
 882                                 assert.ok( true ); // Dummy to reach QUnit expect()
 883
 884                                 verifyModuleStates();
 885
 886                                 QUnit.start();
 887                         },
 888                         function ( e, badmodules ) {
 889                                 assert.ok( true, 'Error handler should be invoked.' );
 890                                 // As soon as server spits out state('testMissing', 'missing');
 891                                 // it will bubble up and trigger the error callback.
 892                                 // Therefor the badmodules array is not testUsesMissing or testUsesNestedMissing.
 893                                 assert.deepEqual( badmodules, [ 'testMissing' ], 'Bad modules as expected.' );
 894
 895                                 verifyModuleStates();
 896
 897                                 QUnit.start();
 898                         }
 899                 );
 900         } );
 901
 902         QUnit.asyncTest( 'mw.loader skin-function handling', 5, function ( assert ) {
 903                 mw.loader.register( [
 904                         // [module, version, dependencies, group, source, skip]
 905                         [ 'testSkipped', '1', [], null, 'testloader', 'return true;' ],
 906                         [ 'testNotSkipped', '1', [], null, 'testloader', 'return false;' ],
 907                         [ 'testUsesSkippable', '1', [ 'testSkipped', 'testNotSkipped' ], null, 'testloader' ]
 908                 ] );
 909
 910                 function verifyModuleStates() {
 911                         assert.equal( mw.loader.getState( 'testSkipped' ), 'ready', 'Module is ready when skipped' );
 912                         assert.equal( mw.loader.getState( 'testNotSkipped' ), 'ready', 'Module is ready when not skipped but loaded' );
 913                         assert.equal( mw.loader.getState( 'testUsesSkippable' ), 'ready', 'Module is ready when skippable dependencies are ready' );
 914                 }
 915
 916                 mw.loader.using( [ 'testUsesSkippable' ],
 917                         function () {
 918                                 assert.ok( true, 'Success handler should be invoked.' );
 919                                 assert.ok( true ); // Dummy to match error handler and reach QUnit expect()
 920
 921                                 verifyModuleStates();
 922
 923                                 QUnit.start();
 924                         },
 925                         function ( e, badmodules ) {
 926                                 assert.ok( false, 'Error handler should not be invoked.' );
 927                                 assert.deepEqual( badmodules, [], 'Bad modules as expected.' );
 928
 929                                 verifyModuleStates();
 930
 931                                 QUnit.start();
 932                         }
 933                 );
 934         } );
 935
 936         QUnit.asyncTest( 'mw.loader( "//protocol-relative" ) (bug 30825)', 2, function ( assert ) {
 937                 // This bug was actually already fixed in 1.18 and later when discovered in 1.17.
 938                 // Test is for regressions!
 939
 940                 // Forge a URL to the test callback script
 941                 var target = QUnit.fixurl(
 942                         mw.config.get( 'wgServer' ) + mw.config.get( 'wgScriptPath' ) + '/tests/qunit/data/qunitOkCall.js'
 943                 );
 944
 945                 // Confirm that mw.loader.load() works with protocol-relative URLs
 946                 target = target.replace( /https?:/, '' );
 947
 948                 assert.equal( target.slice( 0, 2 ), '//',
 949                         'URL must be relative to test relative URLs!'
 950                 );
 951
 952                 // Async!
 953                 // The target calls QUnit.start
 954                 mw.loader.load( target );
 955         } );
 956
 957         QUnit.asyncTest( 'mw.loader( "/absolute-path" )', 2, function ( assert ) {
 958                 // Forge a URL to the test callback script
 959                 var target = QUnit.fixurl(
 960                         mw.config.get( 'wgScriptPath' ) + '/tests/qunit/data/qunitOkCall.js'
 961                 );
 962
 963                 // Confirm that mw.loader.load() works with absolute-paths (relative to current hostname)
 964                 assert.equal( target.slice( 0, 1 ), '/', 'URL is relative to document root' );
 965
 966                 // Async!
 967                 // The target calls QUnit.start
 968                 mw.loader.load( target );
 969         } );
 970
 971         QUnit.test( 'mw.loader() executing race (T112232)', 2, function ( assert ) {
 972                 var done = false;
 973
 974                 // The red herring schedules its CSS buffer first. In T112232, a bug in the
 975                 // state machine would cause the job for testRaceLoadMe to run with an earlier job.
 976                 mw.loader.implement(
 977                         'testRaceRedHerring',
 978                         function () {},
 979                         { css: [ '.mw-testRaceRedHerring {}' ] }
 980                 );
 981                 mw.loader.implement(
 982                         'testRaceLoadMe',
 983                         function () {
 984                                 done = true;
 985                         },
 986                         { css: [ '.mw-testRaceLoadMe { float: left; }' ] }
 987                 );
 988
 989                 mw.loader.load( [ 'testRaceRedHerring', 'testRaceLoadMe' ] );
 990                 return mw.loader.using( 'testRaceLoadMe', function () {
 991                         assert.strictEqual( done, true, 'script ran' );
 992                         assert.strictEqual( mw.loader.getState( 'testRaceLoadMe' ), 'ready', 'state' );
 993                 } );
 994         } );
 995
 996         QUnit.test( 'mw.hook', 13, function ( assert ) {
 997                 var hook, add, fire, chars, callback;
 998
 999                 mw.hook( 'test.hook.unfired' ).add( function () {
1000                         assert.ok( false, 'Unfired hook' );
1001                 } );
1002
1003                 mw.hook( 'test.hook.basic' ).add( function () {
1004                         assert.ok( true, 'Basic callback' );
1005                 } );
1006                 mw.hook( 'test.hook.basic' ).fire();
1007
1008                 mw.hook( 'hasOwnProperty' ).add( function () {
1009                         assert.ok( true, 'hook with name of predefined method' );
1010                 } );
1011                 mw.hook( 'hasOwnProperty' ).fire();
1012
1013                 mw.hook( 'test.hook.data' ).add( function ( data1, data2 ) {
1014                         assert.equal( data1, 'example', 'Fire with data (string param)' );
1015                         assert.deepEqual( data2, [ 'two' ], 'Fire with data (array param)' );
1016                 } );
1017                 mw.hook( 'test.hook.data' ).fire( 'example', [ 'two' ] );
1018
1019                 hook = mw.hook( 'test.hook.chainable' );
1020                 assert.strictEqual( hook.add(), hook, 'hook.add is chainable' );
1021                 assert.strictEqual( hook.remove(), hook, 'hook.remove is chainable' );
1022                 assert.strictEqual( hook.fire(), hook, 'hook.fire is chainable' );
1023
1024                 hook = mw.hook( 'test.hook.detach' );
1025                 add = hook.add;
1026                 fire = hook.fire;
1027                 add( function ( x, y ) {
1028                         assert.deepEqual( [ x, y ], [ 'x', 'y' ], 'Detached (contextless) with data' );
1029                 } );
1030                 fire( 'x', 'y' );
1031
1032                 mw.hook( 'test.hook.fireBefore' ).fire().add( function () {
1033                         assert.ok( true, 'Invoke handler right away if it was fired before' );
1034                 } );
1035
1036                 mw.hook( 'test.hook.fireTwiceBefore' ).fire().fire().add( function () {
1037                         assert.ok( true, 'Invoke handler right away if it was fired before (only last one)' );
1038                 } );
1039
1040                 chars = [];
1041
1042                 mw.hook( 'test.hook.many' )
1043                         .add( function ( chr ) {
1044                                 chars.push( chr );
1045                         } )
1046                         .fire( 'x' ).fire( 'y' ).fire( 'z' )
1047                         .add( function ( chr ) {
1048                                 assert.equal( chr, 'z', 'Adding callback later invokes right away with last data' );
1049                         } );
1050
1051                 assert.deepEqual( chars, [ 'x', 'y', 'z' ], 'Multiple callbacks with multiple fires' );
1052
1053                 chars = [];
1054                 callback = function ( chr ) {
1055                         chars.push( chr );
1056                 };
1057
1058                 mw.hook( 'test.hook.variadic' )
1059                         .add(
1060                                 callback,
1061                                 callback,
1062                                 function ( chr ) {
1063                                         chars.push( chr );
1064                                 },
1065                                 callback
1066                         )
1067                         .fire( 'x' )
1068                         .remove(
1069                                 function () {
1070                                         'not-added';
1071                                 },
1072                                 callback
1073                         )
1074                         .fire( 'y' )
1075                         .remove( callback )
1076                         .fire( 'z' );
1077
1078                 assert.deepEqual(
1079                         chars,
1080                         [ 'x', 'x', 'x', 'x', 'y', 'z' ],
1081                         '"add" and "remove" support variadic arguments. ' +
1082                                 '"add" does not filter unique. ' +
1083                                 '"remove" removes all equal by reference. ' +
1084                                 '"remove" is silent if the function is not found'
1085                 );
1086         } );
1087
1088         QUnit.test( 'mw.loader require()', 6, function ( assert ) {
1089                 mw.loader.register( [
1090                         [ 'test.require1', '0' ],
1091                         [ 'test.require2', '0' ],
1092                         [ 'test.require3', '0' ],
1093                         [ 'test.require4', '0', [ 'test.require3' ] ]
1094                 ] );
1095                 mw.loader.implement( 'test.require1', function () {} );
1096                 mw.loader.implement( 'test.require2', function ( $, jQuery, require, module ) {
1097                         module.exports = 1;
1098                 } );
1099                 mw.loader.implement( 'test.require3', function ( $, jQuery, require, module ) {
1100                         module.exports = function () {
1101                                 return 'hello world';
1102                         };
1103                 } );
1104                 mw.loader.implement( 'test.require4', function ( $, jQuery, require, module ) {
1105                         var other = require( 'test.require3' );
1106                         module.exports = {
1107                                 pizza: function () {
1108                                         return other();
1109                                 }
1110                         };
1111                 } );
1112                 return mw.loader.using( [ 'test.require1', 'test.require2', 'test.require3', 'test.require4' ] )
1113                 .then( function ( require ) {
1114                         var module1, module2, module3, module4;
1115
1116                         module1 = require( 'test.require1' );
1117                         module2 = require( 'test.require2' );
1118                         module3 = require( 'test.require3' );
1119                         module4 = require( 'test.require4' );
1120
1121                         assert.strictEqual( typeof module1, 'object', 'export of module with no export' );
1122                         assert.strictEqual( module2, 1, 'export a number' );
1123                         assert.strictEqual( module3(), 'hello world', 'export a function' );
1124                         assert.strictEqual( typeof module4.pizza, 'function', 'export an object' );
1125                         assert.strictEqual( module4.pizza(), 'hello world', 'module can require other modules' );
1126
1127                         assert.throws( function () {
1128                                 require( '_badmodule' );
1129                         }, /is not loaded/, 'Requesting non-existent modules throws error.' );
1130                 } );
1131         } );
1132
1133         QUnit.test( 'mw.loader require() in debug mode', 1, function ( assert ) {
1134                 var path = mw.config.get( 'wgScriptPath' );
1135                 mw.loader.register( [
1136                         [ 'test.require.define', '0' ],
1137                         [ 'test.require.callback', '0', [ 'test.require.define' ] ]
1138                 ] );
1139                 mw.loader.implement( 'test.require.callback', [ QUnit.fixurl( path + '/tests/qunit/data/requireCallMwLoaderTestCallback.js' ) ] );
1140                 mw.loader.implement( 'test.require.define', [ QUnit.fixurl( path + '/tests/qunit/data/defineCallMwLoaderTestCallback.js' ) ] );
1141
1142                 return mw.loader.using( 'test.require.callback' ).then( function ( require ) {
1143                         var exported = require( 'test.require.callback' );
1144                         assert.strictEqual( exported, 'Require worked.Define worked.',
1145                                 'module.exports worked in debug mode' );
1146                 }, function () {
1147                         assert.ok( false, 'Error callback fired while loader.using "test.require.callback" module' );
1148                 } );
1149         } );
1150
1151 }( mediaWiki, jQuery ) );