2 var specialCharactersPageName
,
3 // Can't mock SITENAME since jqueryMsg caches it at load
4 siteName
= mw
.config
.get( 'wgSiteName' );
6 // Since QUnitTestResources.php loads both mediawiki and mediawiki.jqueryMsg as
7 // dependencies, this only tests the monkey-patched behavior with the two of them combined.
9 // See mediawiki.jqueryMsg.test.js for unit tests for jqueryMsg-specific functionality.
11 QUnit
.module( 'mediawiki', QUnit
.newMwEnvironment( {
13 specialCharactersPageName
= '"Who" wants to be a millionaire & live on \'Exotic Island\'?';
16 wgArticlePath
: '/wiki/$1',
18 // For formatnum tests
21 // Messages used in multiple tests
23 'other-message': 'Other Message',
24 'mediawiki-test-pagetriage-del-talk-page-notify-summary': 'Notifying author of deletion nomination for [[$1]]',
25 'gender-plural-msg': '{{GENDER:$1|he|she|they}} {{PLURAL:$2|is|are}} awesome',
26 'grammar-msg': 'Przeszukaj {{GRAMMAR:grammar_case_foo|{{SITENAME}}}}',
27 'formatnum-msg': '{{formatnum:$1}}',
28 'int-msg': 'Some {{int:other-message}}',
29 'mediawiki-test-version-entrypoints-index-php': '[https://www.mediawiki.org/wiki/Manual:index.php index.php]',
30 'external-link-replace': 'Foo [$1 bar]'
34 QUnit
.test( 'Initial check', function ( assert
) {
35 assert
.ok( window
.jQuery
, 'jQuery defined' );
36 assert
.ok( window
.$, '$ defined' );
37 assert
.strictEqual( window
.$, window
.jQuery
, '$ alias to jQuery' );
39 this.suppressWarnings();
40 assert
.ok( window
.$j
, '$j defined' );
41 assert
.strictEqual( window
.$j
, window
.jQuery
, '$j alias to jQuery' );
42 this.restoreWarnings();
44 // window.mw and window.mediaWiki are not deprecated, but for some reason
45 // PhantomJS is triggerring the accessors on all mw.* properties in this test,
46 // and with that lots of unrelated deprecation notices.
47 this.suppressWarnings();
48 assert
.ok( window
.mediaWiki
, 'mediaWiki defined' );
49 assert
.ok( window
.mw
, 'mw defined' );
50 assert
.strictEqual( window
.mw
, window
.mediaWiki
, 'mw alias to mediaWiki' );
51 this.restoreWarnings();
54 QUnit
.test( 'mw.format', function ( assert
) {
56 mw
.format( 'Format $1 $2', 'foo', 'bar' ),
61 mw
.format( 'Format $1 $2' ),
67 QUnit
.test( 'mw.now', function ( assert
) {
68 assert
.equal( typeof mw
.now(), 'number', 'Return a number' );
70 String( Math
.round( mw
.now() ) ).length
,
71 String( +new Date() ).length
,
72 'Match size of current timestamp'
76 QUnit
.test( 'mw.Map', function ( assert
) {
77 var arry
, conf
, funky
, globalConf
, nummy
, someValues
;
82 funky = function () {};
88 assert
.strictEqual( conf
.set( 'foo', 'Bar' ), true, 'Map.set returns boolean true if a value was set for a valid key string' );
89 assert
.equal( conf
.get( 'foo' ), 'Bar', 'Map.get returns a single value value correctly' );
91 assert
.strictEqual( conf
.get( 'example' ), null, 'Map.get returns null if selection was a string and the key was not found' );
92 assert
.strictEqual( conf
.get( 'example', arry
), arry
, 'Map.get returns fallback by reference if the key was not found' );
93 assert
.strictEqual( conf
.get( 'example', undefined ), undefined, 'Map.get supports `undefined` as fallback instead of `null`' );
95 assert
.strictEqual( conf
.get( 'constructor' ), null, 'Map.get does not look at Object.prototype of internal storage (constructor)' );
96 assert
.strictEqual( conf
.get( 'hasOwnProperty' ), null, 'Map.get does not look at Object.prototype of internal storage (hasOwnProperty)' );
98 conf
.set( 'hasOwnProperty', function () { return true; } );
99 assert
.strictEqual( conf
.get( 'example', 'missing' ), 'missing', 'Map.get uses neutral hasOwnProperty method (positive)' );
101 conf
.set( 'example', 'Foo' );
102 conf
.set( 'hasOwnProperty', function () { return false; } );
103 assert
.strictEqual( conf
.get( 'example' ), 'Foo', 'Map.get uses neutral hasOwnProperty method (negative)' );
105 assert
.strictEqual( conf
.set( 'constructor', 42 ), true, 'Map.set for key "constructor"' );
106 assert
.strictEqual( conf
.get( 'constructor' ), 42, 'Map.get for key "constructor"' );
108 assert
.strictEqual( conf
.set( 'undef' ), false, 'Map.set requires explicit value (no undefined default)' );
110 assert
.strictEqual( conf
.set( 'undef', undefined ), true, 'Map.set allows setting value to `undefined`' );
111 assert
.equal( conf
.get( 'undef', 'fallback' ), undefined, 'Map.get supports retreiving value of `undefined`' );
113 assert
.strictEqual( conf
.set( funky
, 'Funky' ), false, 'Map.set returns boolean false if key was invalid (Function)' );
114 assert
.strictEqual( conf
.set( arry
, 'Arry' ), false, 'Map.set returns boolean false if key was invalid (Array)' );
115 assert
.strictEqual( conf
.set( nummy
, 'Nummy' ), false, 'Map.set returns boolean false if key was invalid (Number)' );
117 assert
.strictEqual( conf
.get( funky
), null, 'Map.get ruturns null if selection was invalid (Function)' );
118 assert
.strictEqual( conf
.get( nummy
), null, 'Map.get ruturns null if selection was invalid (Number)' );
120 conf
.set( String( nummy
), 'I used to be a number' );
122 assert
.strictEqual( conf
.exists( 'doesNotExist' ), false, 'Map.exists where property does not exist' );
123 assert
.strictEqual( conf
.exists( 'undef' ), true, 'Map.exists where value is `undefined`' );
124 assert
.strictEqual( conf
.exists( nummy
), false, 'Map.exists where key is invalid but looks like an existing key' );
126 // Multiple values at once
132 assert
.strictEqual( conf
.set( someValues
), true, 'Map.set returns boolean true if multiple values were set by passing an object' );
133 assert
.deepEqual( conf
.get( [ 'foo', 'lorem' ] ), {
136 }, 'Map.get returns multiple values correctly as an object' );
138 assert
.deepEqual( conf
.get( [ 'foo', 'notExist' ] ), {
141 }, 'Map.get return includes keys that were not found as null values' );
143 // Interacting with globals and accessing the values object
144 this.suppressWarnings();
145 assert
.strictEqual( conf
.get(), conf
.values
, 'Map.get returns the entire values object by reference (if called without arguments)' );
146 this.restoreWarnings();
148 conf
.set( 'globalMapChecker', 'Hi' );
150 assert
.ok( ( 'globalMapChecker' in window
) === false, 'Map does not its store values in the window object by default' );
152 globalConf
= new mw
.Map( true );
153 globalConf
.set( 'anotherGlobalMapChecker', 'Hello' );
155 assert
.ok( 'anotherGlobalMapChecker' in window
, 'global Map stores its values in the window object' );
157 assert
.equal( globalConf
.get( 'anotherGlobalMapChecker' ), 'Hello', 'get value from global Map via get()' );
158 this.suppressWarnings();
159 assert
.equal( window
.anotherGlobalMapChecker
, 'Hello', 'get value from global Map via window object' );
160 this.restoreWarnings();
162 // Change value via global Map
163 globalConf
.set( 'anotherGlobalMapChecker', 'Again' );
164 assert
.equal( globalConf
.get( 'anotherGlobalMapChecker' ), 'Again', 'Change in global Map reflected via get()' );
165 this.suppressWarnings();
166 assert
.equal( window
.anotherGlobalMapChecker
, 'Again', 'Change in global Map reflected window object' );
167 this.restoreWarnings();
169 // Change value via window object
170 this.suppressWarnings();
171 window
.anotherGlobalMapChecker
= 'World';
172 assert
.equal( window
.anotherGlobalMapChecker
, 'World', 'Change in window object works' );
173 this.restoreWarnings();
174 assert
.equal( globalConf
.get( 'anotherGlobalMapChecker' ), 'Again', 'Change in window object not reflected in global Map' );
176 // Whitelist this global variable for QUnit's 'noglobal' mode
177 if ( QUnit
.config
.noglobals
) {
178 QUnit
.config
.pollution
.push( 'anotherGlobalMapChecker' );
182 QUnit
.test( 'mw.message & mw.messages', function ( assert
) {
185 // Convenience method for asserting the same result for multiple formats
186 function assertMultipleFormats( messageArguments
, formats
, expectedResult
, assertMessage
) {
188 len
= formats
.length
;
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
);
196 assert
.ok( mw
.messages
, 'messages defined' );
197 assert
.ok( mw
.messages
.set( 'hello', 'Hello <b>awesome</b> world' ), 'mw.messages.set: Register' );
199 hello
= mw
.message( 'hello' );
201 // https://phabricator.wikimedia.org/T46459
202 assert
.equal( hello
.format
, 'text', 'Message property "format" defaults to "text"' );
204 assert
.strictEqual( hello
.map
, mw
.messages
, 'Message property "map" defaults to the global instance in mw.messages' );
205 assert
.equal( hello
.key
, 'hello', 'Message property "key" (currect key)' );
206 assert
.deepEqual( hello
.parameters
, [], 'Message property "parameters" defaults to an empty array' );
209 assert
.ok( hello
.params
, 'Message prototype "params"' );
211 hello
.format
= 'plain';
212 assert
.equal( hello
.toString(), 'Hello <b>awesome</b> world', 'Message.toString returns the message as a string with the current "format"' );
214 assert
.equal( hello
.escaped(), 'Hello <b>awesome</b> world', 'Message.escaped returns the escaped message' );
215 assert
.equal( hello
.format
, 'escaped', 'Message.escaped correctly updated the "format" property' );
217 assert
.ok( mw
.messages
.set( 'multiple-curly-brace', '"{{SITENAME}}" is the home of {{int:other-message}}' ), 'mw.messages.set: Register' );
218 assertMultipleFormats( [ 'multiple-curly-brace' ], [ 'text', 'parse' ], '"' + siteName
+ '" is the home of Other Message', 'Curly brace format works correctly' );
219 assert
.equal( mw
.message( 'multiple-curly-brace' ).plain(), mw
.messages
.get( 'multiple-curly-brace' ), 'Plain format works correctly for curly brace message' );
220 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 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' );
223 assertMultipleFormats( [ 'multiple-square-brackets-and-ampersand' ], [ 'plain', 'text' ], mw
.messages
.get( 'multiple-square-brackets-and-ampersand' ), 'Square bracket message is not processed' );
224 assert
.equal( mw
.message( 'multiple-square-brackets-and-ampersand' ).escaped(), 'Visit the [[Project:Community portal|community portal]] & [[Project:Help desk|help desk]]', 'Escaped format works correctly for square bracket message' );
225 assert
.htmlEqual( mw
.message( 'multiple-square-brackets-and-ampersand' ).parse(), 'Visit the ' +
226 '<a title="Project:Community portal" href="/wiki/Project:Community_portal">community portal</a>' +
227 ' & <a title="Project:Help desk" href="/wiki/Project:Help_desk">help desk</a>', 'Internal links work with parse' );
229 assertMultipleFormats( [ 'mediawiki-test-version-entrypoints-index-php' ], [ 'plain', 'text', 'escaped' ], mw
.messages
.get( 'mediawiki-test-version-entrypoints-index-php' ), 'External link markup is unprocessed' );
230 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 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' );
233 assert
.equal( mw
.message( 'external-link-replace', 'http://example.org/?x=y&z' ).escaped(), 'Foo [http://example.org/?x=y&z bar]', 'In escaped mode, parameters are substituted and ampersand is escaped, but external link is not processed' );
234 assert
.htmlEqual( mw
.message( 'external-link-replace', 'http://example.org/?x=y&z' ).parse(), 'Foo <a href="http://example.org/?x=y&z">bar</a>', 'External link with replacement works in parse mode without double-escaping' );
237 assert
.equal( hello
.format
, 'parse', 'Message.parse correctly updated the "format" property' );
240 assert
.equal( hello
.format
, 'plain', 'Message.plain correctly updated the "format" property' );
243 assert
.equal( hello
.format
, 'text', 'Message.text correctly updated the "format" property' );
245 assert
.strictEqual( hello
.exists(), true, 'Message.exists returns true for existing messages' );
247 goodbye
= mw
.message( 'goodbye' );
248 assert
.strictEqual( goodbye
.exists(), false, 'Message.exists returns false for nonexistent messages' );
250 assertMultipleFormats( [ 'good<>bye' ], [ 'plain', 'text', 'parse', 'escaped' ], '⧼good<>bye⧽', 'Message.toString returns ⧼key⧽ if key does not exist' );
252 assert
.ok( mw
.messages
.set( 'plural-test-msg', 'There {{PLURAL:$1|is|are}} $1 {{PLURAL:$1|result|results}}' ), 'mw.messages.set: Register' );
253 assertMultipleFormats( [ 'plural-test-msg', 6 ], [ 'text', 'parse', 'escaped' ], 'There are 6 results', 'plural get resolved' );
254 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' );
256 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' );
257 assertMultipleFormats( [ 'plural-test-msg-explicit', 12 ], [ 'text', 'parse', 'escaped' ], 'There are a dozen cars', 'explicit plural get resolved' );
259 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' );
260 assertMultipleFormats( [ 'plural-test-msg-explicit-beginning', 1 ], [ 'text', 'parse', 'escaped' ], 'Basket has one egg', 'explicit plural given at beginning get resolved for singular' );
261 assertMultipleFormats( [ 'plural-test-msg-explicit-beginning', 4 ], [ 'text', 'parse', 'escaped' ], 'Basket has 4 eggs', 'explicit plural given at beginning get resolved for plural' );
262 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' );
263 assertMultipleFormats( [ 'plural-test-msg-explicit-beginning', 0 ], [ 'text', 'parse', 'escaped' ], 'Basket has no eggs', 'explicit plural given at beginning get resolved for 0' );
265 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' );
267 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' );
269 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' );
271 assert
.ok( mw
.messages
.set( 'mediawiki-test-categorytree-collapse-bullet', '[<b>−</b>]' ), 'mw.messages.set: Register' );
272 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' );
274 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' );
275 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' );
277 assertMultipleFormats( [ 'gender-plural-msg', 'male', 1 ], [ 'text', 'parse', 'escaped' ], 'he is awesome', 'Gender and plural are resolved' );
278 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' );
280 assert
.equal( mw
.message( 'grammar-msg' ).plain(), mw
.messages
.get( 'grammar-msg' ), 'Grammar is not resolved in plain mode' );
281 assertMultipleFormats( [ 'grammar-msg' ], [ 'text', 'parse' ], 'Przeszukaj ' + siteName
, 'Grammar is resolved' );
282 assert
.equal( mw
.message( 'grammar-msg' ).escaped(), 'Przeszukaj ' + siteName
, 'Grammar is resolved in escaped mode' );
284 assertMultipleFormats( [ 'formatnum-msg', '987654321.654321' ], [ 'text', 'parse', 'escaped' ], '987,654,321.654', 'formatnum is resolved' );
285 assert
.equal( mw
.message( 'formatnum-msg' ).plain(), mw
.messages
.get( 'formatnum-msg' ), 'formatnum is not resolved in plain mode' );
287 assertMultipleFormats( [ 'int-msg' ], [ 'text', 'parse', 'escaped' ], 'Some Other Message', 'int is resolved' );
288 assert
.equal( mw
.message( 'int-msg' ).plain(), mw
.messages
.get( 'int-msg' ), 'int is not resolved in plain mode' );
290 assert
.ok( mw
.messages
.set( 'mediawiki-italics-msg', '<i>Very</i> important' ), 'mw.messages.set: Register' );
291 assertMultipleFormats( [ 'mediawiki-italics-msg' ], [ 'plain', 'text', 'parse' ], mw
.messages
.get( 'mediawiki-italics-msg' ), 'Simple italics unchanged' );
293 mw
.message( 'mediawiki-italics-msg' ).escaped(),
294 '<i>Very</i> important',
295 'Italics are escaped in escaped mode'
298 assert
.ok( mw
.messages
.set( 'mediawiki-italics-with-link', 'An <i>italicized [[link|wiki-link]]</i>' ), 'mw.messages.set: Register' );
299 assertMultipleFormats( [ 'mediawiki-italics-with-link' ], [ 'plain', 'text' ], mw
.messages
.get( 'mediawiki-italics-with-link' ), 'Italics with link unchanged' );
301 mw
.message( 'mediawiki-italics-with-link' ).escaped(),
302 'An <i>italicized [[link|wiki-link]]</i>',
303 'Italics and link unchanged except for escaping in escaped mode'
306 mw
.message( 'mediawiki-italics-with-link' ).parse(),
307 'An <i>italicized <a title="link" href="' + mw
.util
.getUrl( 'link' ) + '">wiki-link</i>',
308 'Italics with link inside in parse mode'
311 assert
.ok( mw
.messages
.set( 'mediawiki-script-msg', '<script >alert( "Who put this script here?" );</script>' ), 'mw.messages.set: Register' );
312 assertMultipleFormats( [ 'mediawiki-script-msg' ], [ 'plain', 'text' ], mw
.messages
.get( 'mediawiki-script-msg' ), 'Script unchanged' );
314 mw
.message( 'mediawiki-script-msg' ).escaped(),
315 '<script >alert( "Who put this script here?" );</script>',
316 'Script escaped when using escaped format'
319 mw
.message( 'mediawiki-script-msg' ).parse(),
320 '<script >alert( "Who put this script here?" );</script>',
321 'Script escaped when using parse format'
326 QUnit
.test( 'mw.msg', function ( assert
) {
327 assert
.ok( mw
.messages
.set( 'hello', 'Hello <b>awesome</b> world' ), 'mw.messages.set: Register' );
328 assert
.equal( mw
.msg( 'hello' ), 'Hello <b>awesome</b> world', 'Gets message with default options (existing message)' );
329 assert
.equal( mw
.msg( 'goodbye' ), '⧼goodbye⧽', 'Gets message with default options (nonexistent message)' );
331 assert
.ok( mw
.messages
.set( 'plural-item', 'Found $1 {{PLURAL:$1|item|items}}' ), 'mw.messages.set: Register' );
332 assert
.equal( mw
.msg( 'plural-item', 5 ), 'Found 5 items', 'Apply plural for count 5' );
333 assert
.equal( mw
.msg( 'plural-item', 0 ), 'Found 0 items', 'Apply plural for count 0' );
334 assert
.equal( mw
.msg( 'plural-item', 1 ), 'Found 1 item', 'Apply plural for count 1' );
336 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' );
338 assert
.equal( mw
.msg( 'gender-plural-msg', 'male', 1 ), 'he is awesome', 'Gender test for male, plural count 1' );
339 assert
.equal( mw
.msg( 'gender-plural-msg', 'female', '1' ), 'she is awesome', 'Gender test for female, plural count 1' );
340 assert
.equal( mw
.msg( 'gender-plural-msg', 'unknown', 10 ), 'they are awesome', 'Gender test for neutral, plural count 10' );
342 assert
.equal( mw
.msg( 'grammar-msg' ), 'Przeszukaj ' + siteName
, 'Grammar is resolved' );
344 assert
.equal( mw
.msg( 'formatnum-msg', '987654321.654321' ), '987,654,321.654', 'formatnum is resolved' );
346 assert
.equal( mw
.msg( 'int-msg' ), 'Some Other Message', 'int is resolved' );
349 QUnit
.test( 'mw.hook', function ( assert
) {
350 var hook
, add
, fire
, chars
, callback
;
352 mw
.hook( 'test.hook.unfired' ).add( function () {
353 assert
.ok( false, 'Unfired hook' );
356 mw
.hook( 'test.hook.basic' ).add( function () {
357 assert
.ok( true, 'Basic callback' );
359 mw
.hook( 'test.hook.basic' ).fire();
361 mw
.hook( 'hasOwnProperty' ).add( function () {
362 assert
.ok( true, 'hook with name of predefined method' );
364 mw
.hook( 'hasOwnProperty' ).fire();
366 mw
.hook( 'test.hook.data' ).add( function ( data1
, data2
) {
367 assert
.equal( data1
, 'example', 'Fire with data (string param)' );
368 assert
.deepEqual( data2
, [ 'two' ], 'Fire with data (array param)' );
370 mw
.hook( 'test.hook.data' ).fire( 'example', [ 'two' ] );
372 hook
= mw
.hook( 'test.hook.chainable' );
373 assert
.strictEqual( hook
.add(), hook
, 'hook.add is chainable' );
374 assert
.strictEqual( hook
.remove(), hook
, 'hook.remove is chainable' );
375 assert
.strictEqual( hook
.fire(), hook
, 'hook.fire is chainable' );
377 hook
= mw
.hook( 'test.hook.detach' );
380 add( function ( x
, y
) {
381 assert
.deepEqual( [ x
, y
], [ 'x', 'y' ], 'Detached (contextless) with data' );
385 mw
.hook( 'test.hook.fireBefore' ).fire().add( function () {
386 assert
.ok( true, 'Invoke handler right away if it was fired before' );
389 mw
.hook( 'test.hook.fireTwiceBefore' ).fire().fire().add( function () {
390 assert
.ok( true, 'Invoke handler right away if it was fired before (only last one)' );
395 mw
.hook( 'test.hook.many' )
396 .add( function ( chr
) {
399 .fire( 'x' ).fire( 'y' ).fire( 'z' )
400 .add( function ( chr
) {
401 assert
.equal( chr
, 'z', 'Adding callback later invokes right away with last data' );
404 assert
.deepEqual( chars
, [ 'x', 'y', 'z' ], 'Multiple callbacks with multiple fires' );
407 callback = function ( chr
) {
411 mw
.hook( 'test.hook.variadic' )
433 [ 'x', 'x', 'x', 'x', 'y', 'z' ],
434 '"add" and "remove" support variadic arguments. ' +
435 '"add" does not filter unique. ' +
436 '"remove" removes all equal by reference. ' +
437 '"remove" is silent if the function is not found'