path: root/www/wiki/tests/qunit/suites/resources/mediawiki/mediawiki.test.js

( function ( mw ) {
	var specialCharactersPageName,
		// Can't mock SITENAME since jqueryMsg caches it at load
		siteName = mw.config.get( 'wgSiteName' );

	// Since QUnitTestResources.php loads both mediawiki and mediawiki.jqueryMsg as
	// dependencies, this only tests the monkey-patched behavior with the two of them combined.

	// See mediawiki.jqueryMsg.test.js for unit tests for jqueryMsg-specific functionality.

	QUnit.module( 'mediawiki', QUnit.newMwEnvironment( {
		setup: function () {
			specialCharactersPageName = '"Who" wants to be a millionaire & live on \'Exotic Island\'?';
		},
		config: {
			wgArticlePath: '/wiki/$1',

			// For formatnum tests
			wgUserLanguage: 'en'
		},
		// Messages used in multiple tests
		messages: {
			'other-message': 'Other Message',
			'mediawiki-test-pagetriage-del-talk-page-notify-summary': 'Notifying author of deletion nomination for [[$1]]',
			'gender-plural-msg': '{{GENDER:$1|he|she|they}} {{PLURAL:$2|is|are}} awesome',
			'grammar-msg': 'Przeszukaj {{GRAMMAR:grammar_case_foo|{{SITENAME}}}}',
			'formatnum-msg': '{{formatnum:$1}}',
			'int-msg': 'Some {{int:other-message}}',
			'mediawiki-test-version-entrypoints-index-php': '[https://www.mediawiki.org/wiki/Manual:index.php index.php]',
			'external-link-replace': 'Foo [$1 bar]'
		}
	} ) );

	QUnit.test( 'Initial check', function ( assert ) {
		assert.ok( window.jQuery, 'jQuery defined' );
		assert.ok( window.$, '$ defined' );
		assert.strictEqual( window.$, window.jQuery, '$ alias to jQuery' );

		this.suppressWarnings();
		assert.ok( window.$j, '$j defined' );
		assert.strictEqual( window.$j, window.jQuery, '$j alias to jQuery' );
		this.restoreWarnings();

		// window.mw and window.mediaWiki are not deprecated, but for some reason
		// PhantomJS is triggerring the accessors on all mw.* properties in this test,
		// and with that lots of unrelated deprecation notices.
		this.suppressWarnings();
		assert.ok( window.mediaWiki, 'mediaWiki defined' );
		assert.ok( window.mw, 'mw defined' );
		assert.strictEqual( window.mw, window.mediaWiki, 'mw alias to mediaWiki' );
		this.restoreWarnings();
	} );

	QUnit.test( 'mw.format', function ( assert ) {
		assert.equal(
			mw.format( 'Format $1 $2', 'foo', 'bar' ),
			'Format foo bar',
			'Simple parameters'
		);
		assert.equal(
			mw.format( 'Format $1 $2' ),
			'Format $1 $2',
			'Missing parameters'
		);
	} );

	QUnit.test( 'mw.now', function ( assert ) {
		assert.equal( typeof mw.now(), 'number', 'Return a number' );
		assert.equal(
			String( Math.round( mw.now() ) ).length,
			String( +new Date() ).length,
			'Match size of current timestamp'
		);
	} );

	QUnit.test( 'mw.Map', function ( assert ) {
		var arry, conf, funky, globalConf, nummy, someValues;

		conf = new mw.Map();

		// Dummy variables
		funky = function () {};
		arry = [];
		nummy = 7;

		// Single get and set

		assert.strictEqual( conf.set( 'foo', 'Bar' ), true, 'Map.set returns boolean true if a value was set for a valid key string' );
		assert.equal( conf.get( 'foo' ), 'Bar', 'Map.get returns a single value value correctly' );

		assert.strictEqual( conf.get( 'example' ), null, 'Map.get returns null if selection was a string and the key was not found' );
		assert.strictEqual( conf.get( 'example', arry ), arry, 'Map.get returns fallback by reference if the key was not found' );
		assert.strictEqual( conf.get( 'example', undefined ), undefined, 'Map.get supports `undefined` as fallback instead of `null`' );

		assert.strictEqual( conf.get( 'constructor' ), null, 'Map.get does not look at Object.prototype of internal storage (constructor)' );
		assert.strictEqual( conf.get( 'hasOwnProperty' ), null, 'Map.get does not look at Object.prototype of internal storage (hasOwnProperty)' );

		conf.set( 'hasOwnProperty', function () { return true; } );
		assert.strictEqual( conf.get( 'example', 'missing' ), 'missing', 'Map.get uses neutral hasOwnProperty method (positive)' );

		conf.set( 'example', 'Foo' );
		conf.set( 'hasOwnProperty', function () { return false; } );
		assert.strictEqual( conf.get( 'example' ), 'Foo', 'Map.get uses neutral hasOwnProperty method (negative)' );

		assert.strictEqual( conf.set( 'constructor', 42 ), true, 'Map.set for key "constructor"' );
		assert.strictEqual( conf.get( 'constructor' ), 42, 'Map.get for key "constructor"' );

		assert.strictEqual( conf.set( 'undef' ), false, 'Map.set requires explicit value (no undefined default)' );

		assert.strictEqual( conf.set( 'undef', undefined ), true, 'Map.set allows setting value to `undefined`' );
		assert.equal( conf.get( 'undef', 'fallback' ), undefined, 'Map.get supports retreiving value of `undefined`' );

		assert.strictEqual( conf.set( funky, 'Funky' ), false, 'Map.set returns boolean false if key was invalid (Function)' );
		assert.strictEqual( conf.set( arry, 'Arry' ), false, 'Map.set returns boolean false if key was invalid (Array)' );
		assert.strictEqual( conf.set( nummy, 'Nummy' ), false, 'Map.set returns boolean false if key was invalid (Number)' );

		conf.set( String( nummy ), 'I used to be a number' );

		assert.strictEqual( conf.get( funky ), null, 'Map.get returns null if selection was invalid (Function)' );
		assert.strictEqual( conf.get( nummy ), null, 'Map.get returns null if selection was invalid (Number)' );
		assert.propEqual( conf.get( [ nummy ] ), {}, 'Map.get returns null if selection was invalid (multiple)' );
		assert.strictEqual( conf.get( nummy, false ), false, 'Map.get returns custom fallback for invalid selection' );

		assert.strictEqual( conf.exists( 'doesNotExist' ), false, 'Map.exists where property does not exist' );
		assert.strictEqual( conf.exists( 'undef' ), true, 'Map.exists where value is `undefined`' );
		assert.strictEqual( conf.exists( [ 'undef', 'example' ] ), true, 'Map.exists with multiple keys (all existing)' );
		assert.strictEqual( conf.exists( [ 'example', 'doesNotExist' ] ), false, 'Map.exists with multiple keys (some non-existing)' );
		assert.strictEqual( conf.exists( [] ), true, 'Map.exists with no keys' );
		assert.strictEqual( conf.exists( nummy ), false, 'Map.exists with invalid key that looks like an existing key' );
		assert.strictEqual( conf.exists( [ nummy ] ), false, 'Map.exists with invalid key that looks like an existing key' );

		// Multiple values at once
		conf = new mw.Map();
		someValues = {
			foo: 'bar',
			lorem: 'ipsum',
			MediaWiki: true
		};
		assert.strictEqual( conf.set( someValues ), true, 'Map.set returns boolean true if multiple values were set by passing an object' );
		assert.deepEqual( conf.get( [ 'foo', 'lorem' ] ), {
			foo: 'bar',
			lorem: 'ipsum'
		}, 'Map.get returns multiple values correctly as an object' );

		assert.deepEqual( conf.get( [ 'foo', 'notExist' ] ), {
			foo: 'bar',
			notExist: null
		}, 'Map.get return includes keys that were not found as null values' );

		assert.propEqual( conf.values, someValues, 'Map.values is an internal object with all values (exposed for convenience)' );
		assert.propEqual( conf.get(), someValues, 'Map.get() returns an object with all values' );

		// Interacting with globals
		conf.set( 'globalMapChecker', 'Hi' );

		assert.ok( ( 'globalMapChecker' in window ) === false, 'Map does not its store values in the window object by default' );

		globalConf = new mw.Map( true );
		globalConf.set( 'anotherGlobalMapChecker', 'Hello' );

		assert.ok( 'anotherGlobalMapChecker' in window, 'global Map stores its values in the window object' );

		assert.equal( globalConf.get( 'anotherGlobalMapChecker' ), 'Hello', 'get value from global Map via get()' );
		this.suppressWarnings();
		assert.equal( window.anotherGlobalMapChecker, 'Hello', 'get value from global Map via window object' );
		this.restoreWarnings();

		// Change value via global Map
		globalConf.set( 'anotherGlobalMapChecker', 'Again' );
		assert.equal( globalConf.get( 'anotherGlobalMapChecker' ), 'Again', 'Change in global Map reflected via get()' );
		this.suppressWarnings();
		assert.equal( window.anotherGlobalMapChecker, 'Again', 'Change in global Map reflected window object' );
		this.restoreWarnings();

		// Change value via window object
		this.suppressWarnings();
		window.anotherGlobalMapChecker = 'World';
		assert.equal( window.anotherGlobalMapChecker, 'World', 'Change in window object works' );
		this.restoreWarnings();
		assert.equal( globalConf.get( 'anotherGlobalMapChecker' ), 'Again', 'Change in window object not reflected in global Map' );

		// Whitelist this global variable for QUnit's 'noglobal' mode
		if ( QUnit.config.noglobals ) {
			QUnit.config.pollution.push( 'anotherGlobalMapChecker' );
		}
	} );

	QUnit.test( 'mw.message & mw.messages', function ( assert ) {
		var goodbye, hello;

		// Convenience method for asserting the same result for multiple formats
		function assertMultipleFormats( messageArguments, formats, expectedResult, assertMessage ) {
			var format, i,
				len = formats.length;

			for ( i = 0; i < len; i++ ) {
				format = formats[ i ];
				assert.equal( mw.message.apply( null, messageArguments )[ format ](), expectedResult, assertMessage + ' when format is ' + format );
			}
		}

		assert.ok( mw.messages, 'messages defined' );
		assert.ok( mw.messages.set( 'hello', 'Hello <b>awesome</b> world' ), 'mw.messages.set: Register' );

		hello = mw.message( 'hello' );

		// https://phabricator.wikimedia.org/T46459
		assert.equal( hello.format, 'text', 'Message property "format" defaults to "text"' );

		assert.strictEqual( hello.map, mw.messages, 'Message property "map" defaults to the global instance in mw.messages' );
		assert.equal( hello.key, 'hello', 'Message property "key" (currect key)' );
		assert.deepEqual( hello.parameters, [], 'Message property "parameters" defaults to an empty array' );

		// TODO
		assert.ok( hello.params, 'Message prototype "params"' );

		hello.format = 'plain';
		assert.equal( hello.toString(), 'Hello <b>awesome</b> world', 'Message.toString returns the message as a string with the current "format"' );

		assert.equal( hello.escaped(), 'Hello &lt;b&gt;awesome&lt;/b&gt; world', 'Message.escaped returns the escaped message' );
		assert.equal( hello.format, 'escaped', 'Message.escaped correctly updated the "format" property' );

		assert.ok( mw.messages.set( 'multiple-curly-brace', '"{{SITENAME}}" is the home of {{int:other-message}}' ), 'mw.messages.set: Register' );
		assertMultipleFormats( [ 'multiple-curly-brace' ], [ 'text', 'parse' ], '"' + siteName + '" is the home of Other Message', 'Curly brace format works correctly' );
		assert.equal( mw.message( 'multiple-curly-brace' ).plain(), mw.messages.get( 'multiple-curly-brace' ), 'Plain format works correctly for curly brace message' );
		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' );

		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' );
		assertMultipleFormats( [ 'multiple-square-brackets-and-ampersand' ], [ 'plain', 'text' ], mw.messages.get( 'multiple-square-brackets-and-ampersand' ), 'Square bracket message is not processed' );
		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' );
		assert.htmlEqual( mw.message( 'multiple-square-brackets-and-ampersand' ).parse(), 'Visit the ' +
			'<a title="Project:Community portal" href="/wiki/Project:Community_portal">community portal</a>' +
			' &amp; <a title="Project:Help desk" href="/wiki/Project:Help_desk">help desk</a>', 'Internal links work with parse' );

		assertMultipleFormats( [ 'mediawiki-test-version-entrypoints-index-php' ], [ 'plain', 'text', 'escaped' ], mw.messages.get( 'mediawiki-test-version-entrypoints-index-php' ), 'External link markup is unprocessed' );
		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' );

		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' );
		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' );
		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' );

		hello.parse();
		assert.equal( hello.format, 'parse', 'Message.parse correctly updated the "format" property' );

		hello.plain();
		assert.equal( hello.format, 'plain', 'Message.plain correctly updated the "format" property' );

		hello.text();
		assert.equal( hello.format, 'text', 'Message.text correctly updated the "format" property' );

		assert.strictEqual( hello.exists(), true, 'Message.exists returns true for existing messages' );

		goodbye = mw.message( 'goodbye' );
		assert.strictEqual( goodbye.exists(), false, 'Message.exists returns false for nonexistent messages' );

		assertMultipleFormats( [ 'good<>bye' ], [ 'plain', 'text', 'parse', 'escaped' ], '⧼good&lt;&gt;bye⧽', 'Message.toString returns ⧼key⧽ if key does not exist' );

		assert.ok( mw.messages.set( 'plural-test-msg', 'There {{PLURAL:$1|is|are}} $1 {{PLURAL:$1|result|results}}' ), 'mw.messages.set: Register' );
		assertMultipleFormats( [ 'plural-test-msg', 6 ], [ 'text', 'parse', 'escaped' ], 'There are 6 results', 'plural get resolved' );
		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' );

		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' );
		assertMultipleFormats( [ 'plural-test-msg-explicit', 12 ], [ 'text', 'parse', 'escaped' ], 'There are a dozen cars', 'explicit plural get resolved' );

		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' );
		assertMultipleFormats( [ 'plural-test-msg-explicit-beginning', 1 ], [ 'text', 'parse', 'escaped' ], 'Basket has one egg', 'explicit plural given at beginning get resolved for singular' );
		assertMultipleFormats( [ 'plural-test-msg-explicit-beginning', 4 ], [ 'text', 'parse', 'escaped' ], 'Basket has 4 eggs', 'explicit plural given at beginning get resolved for plural' );
		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' );
		assertMultipleFormats( [ 'plural-test-msg-explicit-beginning', 0 ], [ 'text', 'parse', 'escaped' ], 'Basket has no eggs', 'explicit plural given at beginning get resolved for 0' );

		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' );

		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' );

		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' );

		assert.ok( mw.messages.set( 'mediawiki-test-categorytree-collapse-bullet', '[<b>−</b>]' ), 'mw.messages.set: Register' );
		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' );

		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' );
		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' );

		assertMultipleFormats( [ 'gender-plural-msg', 'male', 1 ], [ 'text', 'parse', 'escaped' ], 'he is awesome', 'Gender and plural are resolved' );
		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' );

		assert.equal( mw.message( 'grammar-msg' ).plain(), mw.messages.get( 'grammar-msg' ), 'Grammar is not resolved in plain mode' );
		assertMultipleFormats( [ 'grammar-msg' ], [ 'text', 'parse' ], 'Przeszukaj ' + siteName, 'Grammar is resolved' );
		assert.equal( mw.message( 'grammar-msg' ).escaped(), 'Przeszukaj ' + siteName, 'Grammar is resolved in escaped mode' );

		assertMultipleFormats( [ 'formatnum-msg', '987654321.654321' ], [ 'text', 'parse', 'escaped' ], '987,654,321.654', 'formatnum is resolved' );
		assert.equal( mw.message( 'formatnum-msg' ).plain(), mw.messages.get( 'formatnum-msg' ), 'formatnum is not resolved in plain mode' );

		assertMultipleFormats( [ 'int-msg' ], [ 'text', 'parse', 'escaped' ], 'Some Other Message', 'int is resolved' );
		assert.equal( mw.message( 'int-msg' ).plain(), mw.messages.get( 'int-msg' ), 'int is not resolved in plain mode' );

		assert.ok( mw.messages.set( 'mediawiki-italics-msg', '<i>Very</i> important' ),	'mw.messages.set: Register' );
		assertMultipleFormats( [ 'mediawiki-italics-msg' ], [ 'plain', 'text', 'parse' ], mw.messages.get( 'mediawiki-italics-msg' ), 'Simple italics unchanged' );
		assert.htmlEqual(
			mw.message( 'mediawiki-italics-msg' ).escaped(),
			'&lt;i&gt;Very&lt;/i&gt; important',
			'Italics are escaped in	escaped mode'
		);

		assert.ok( mw.messages.set( 'mediawiki-italics-with-link', 'An <i>italicized [[link|wiki-link]]</i>' ), 'mw.messages.set: Register' );
		assertMultipleFormats( [ 'mediawiki-italics-with-link' ], [ 'plain', 'text' ], mw.messages.get( 'mediawiki-italics-with-link' ), 'Italics with link unchanged' );
		assert.htmlEqual(
			mw.message( 'mediawiki-italics-with-link' ).escaped(),
			'An &lt;i&gt;italicized [[link|wiki-link]]&lt;/i&gt;',
			'Italics and link unchanged except for escaping in escaped mode'
		);
		assert.htmlEqual(
			mw.message( 'mediawiki-italics-with-link' ).parse(),
			'An <i>italicized <a title="link" href="' + mw.util.getUrl( 'link' ) + '">wiki-link</i>',
			'Italics with link inside in parse mode'
		);

		assert.ok( mw.messages.set( 'mediawiki-script-msg', '<script  >alert( "Who put this script here?" );</script>' ), 'mw.messages.set: Register' );
		assertMultipleFormats( [ 'mediawiki-script-msg' ], [ 'plain', 'text' ], mw.messages.get( 'mediawiki-script-msg' ), 'Script unchanged' );
		assert.htmlEqual(
			mw.message( 'mediawiki-script-msg' ).escaped(),
			'&lt;script  &gt;alert( "Who put this script here?" );&lt;/script&gt;',
			'Script escaped when using escaped format'
		);
		assert.htmlEqual(
			mw.message( 'mediawiki-script-msg' ).parse(),
			'&lt;script  &gt;alert( "Who put this script here?" );&lt;/script&gt;',
			'Script escaped when using parse format'
		);

	} );

	QUnit.test( 'mw.msg', function ( assert ) {
		assert.ok( mw.messages.set( 'hello', 'Hello <b>awesome</b> world' ), 'mw.messages.set: Register' );
		assert.equal( mw.msg( 'hello' ), 'Hello <b>awesome</b> world', 'Gets message with default options (existing message)' );
		assert.equal( mw.msg( 'goodbye' ), '⧼goodbye⧽', 'Gets message with default options (nonexistent message)' );

		assert.ok( mw.messages.set( 'plural-item', 'Found $1 {{PLURAL:$1|item|items}}' ), 'mw.messages.set: Register' );
		assert.equal( mw.msg( 'plural-item', 5 ), 'Found 5 items', 'Apply plural for count 5' );
		assert.equal( mw.msg( 'plural-item', 0 ), 'Found 0 items', 'Apply plural for count 0' );
		assert.equal( mw.msg( 'plural-item', 1 ), 'Found 1 item', 'Apply plural for count 1' );

		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' );

		assert.equal( mw.msg( 'gender-plural-msg', 'male', 1 ), 'he is awesome', 'Gender test for male, plural count 1' );
		assert.equal( mw.msg( 'gender-plural-msg', 'female', '1' ), 'she is awesome', 'Gender test for female, plural count 1' );
		assert.equal( mw.msg( 'gender-plural-msg', 'unknown', 10 ), 'they are awesome', 'Gender test for neutral, plural count 10' );

		assert.equal( mw.msg( 'grammar-msg' ), 'Przeszukaj ' + siteName, 'Grammar is resolved' );

		assert.equal( mw.msg( 'formatnum-msg', '987654321.654321' ), '987,654,321.654', 'formatnum is resolved' );

		assert.equal( mw.msg( 'int-msg' ), 'Some Other Message', 'int is resolved' );
	} );

	QUnit.test( 'mw.hook', function ( assert ) {
		var hook, add, fire, chars, callback;

		mw.hook( 'test.hook.unfired' ).add( function () {
			assert.ok( false, 'Unfired hook' );
		} );

		mw.hook( 'test.hook.basic' ).add( function () {
			assert.ok( true, 'Basic callback' );
		} );
		mw.hook( 'test.hook.basic' ).fire();

		mw.hook( 'hasOwnProperty' ).add( function () {
			assert.ok( true, 'hook with name of predefined method' );
		} );
		mw.hook( 'hasOwnProperty' ).fire();

		mw.hook( 'test.hook.data' ).add( function ( data1, data2 ) {
			assert.equal( data1, 'example', 'Fire with data (string param)' );
			assert.deepEqual( data2, [ 'two' ], 'Fire with data (array param)' );
		} );
		mw.hook( 'test.hook.data' ).fire( 'example', [ 'two' ] );

		hook = mw.hook( 'test.hook.chainable' );
		assert.strictEqual( hook.add(), hook, 'hook.add is chainable' );
		assert.strictEqual( hook.remove(), hook, 'hook.remove is chainable' );
		assert.strictEqual( hook.fire(), hook, 'hook.fire is chainable' );

		hook = mw.hook( 'test.hook.detach' );
		add = hook.add;
		fire = hook.fire;
		add( function ( x, y ) {
			assert.deepEqual( [ x, y ], [ 'x', 'y' ], 'Detached (contextless) with data' );
		} );
		fire( 'x', 'y' );

		mw.hook( 'test.hook.fireBefore' ).fire().add( function () {
			assert.ok( true, 'Invoke handler right away if it was fired before' );
		} );

		mw.hook( 'test.hook.fireTwiceBefore' ).fire().fire().add( function () {
			assert.ok( true, 'Invoke handler right away if it was fired before (only last one)' );
		} );

		chars = [];

		mw.hook( 'test.hook.many' )
			.add( function ( chr ) {
				chars.push( chr );
			} )
			.fire( 'x' ).fire( 'y' ).fire( 'z' )
			.add( function ( chr ) {
				assert.equal( chr, 'z', 'Adding callback later invokes right away with last data' );
			} );

		assert.deepEqual( chars, [ 'x', 'y', 'z' ], 'Multiple callbacks with multiple fires' );

		chars = [];
		callback = function ( chr ) {
			chars.push( chr );
		};

		mw.hook( 'test.hook.variadic' )
			.add(
				callback,
				callback,
				function ( chr ) {
					chars.push( chr );
				},
				callback
			)
			.fire( 'x' )
			.remove(
				function () {
					'not-added';
				},
				callback
			)
			.fire( 'y' )
			.remove( callback )
			.fire( 'z' );

		assert.deepEqual(
			chars,
			[ 'x', 'x', 'x', 'x', 'y', 'z' ],
			'"add" and "remove" support variadic arguments. ' +
				'"add" does not filter unique. ' +
				'"remove" removes all equal by reference. ' +
				'"remove" is silent if the function is not found'
		);
	} );

}( mediaWiki ) );