MessageTest.php

Go to the documentation of this file.

<?php
 
use Wikimedia\ObjectFactory;
use Wikimedia\TestingAccessWrapper;
 
class MessageTest extends MediaWikiLangTestCase {
 
    protected function setUp() {
        parent::setUp();
 
        $this->setMwGlobals( [
            'wgForceUIMsgAsContentMsg' => [],
        ] );
        $this->setUserLang( 'en' );
    }
 
    public function testConstructor( $expectedLang, $key, $params, $language ) {
        $message = new Message( $key, $params, $language );
 
        $this->assertSame( $key, $message->getKey() );
        $this->assertSame( $params, $message->getParams() );
        $this->assertEquals( $expectedLang, $message->getLanguage() );
 
        $messageSpecifier = $this->getMockForAbstractClass( MessageSpecifier::class );
        $messageSpecifier->expects( $this->any() )
            ->method( 'getKey' )->will( $this->returnValue( $key ) );
        $messageSpecifier->expects( $this->any() )
            ->method( 'getParams' )->will( $this->returnValue( $params ) );
        $message = new Message( $messageSpecifier, [], $language );
 
        $this->assertSame( $key, $message->getKey() );
        $this->assertSame( $params, $message->getParams() );
        $this->assertEquals( $expectedLang, $message->getLanguage() );
    }
 
    public static function provideConstructor() {
        $langDe = Language::factory( 'de' );
        $langEn = Language::factory( 'en' );
 
        return [
            [ $langDe, 'foo', [], $langDe ],
            [ $langDe, 'foo', [ 'bar' ], $langDe ],
            [ $langEn, 'foo', [ 'bar' ], null ]
        ];
    }
 
    public static function provideConstructorParams() {
        return [
            [
                [],
                [],
            ],
            [
                [],
                [ [] ],
            ],
            [
                [ 'foo' ],
                [ 'foo' ],
            ],
            [
                [ 'foo', 'bar' ],
                [ 'foo', 'bar' ],
            ],
            [
                [ 'baz' ],
                [ [ 'baz' ] ],
            ],
            [
                [ 'baz', 'foo' ],
                [ [ 'baz', 'foo' ] ],
            ],
            [
                [ Message::rawParam( 'baz' ) ],
                [ Message::rawParam( 'baz' ) ],
            ],
            [
                [ Message::rawParam( 'baz' ), 'foo' ],
                [ Message::rawParam( 'baz' ), 'foo' ],
            ],
            [
                [ Message::rawParam( 'baz' ) ],
                [ [ Message::rawParam( 'baz' ) ] ],
            ],
            [
                [ Message::rawParam( 'baz' ), 'foo' ],
                [ [ Message::rawParam( 'baz' ), 'foo' ] ],
            ],
 
            // Test handling of erroneous input, to detect if it changes
            [
                [ [ 'baz', 'foo' ], 'hhh' ],
                [ [ 'baz', 'foo' ], 'hhh' ],
            ],
            [
                [ [ 'baz', 'foo' ], 'hhh', [ 'ahahahahha' ] ],
                [ [ 'baz', 'foo' ], 'hhh', [ 'ahahahahha' ] ],
            ],
            [
                [ [ 'baz', 'foo' ], [ 'ahahahahha' ] ],
                [ [ 'baz', 'foo' ], [ 'ahahahahha' ] ],
            ],
            [
                [ [ 'baz' ], [ 'ahahahahha' ] ],
                [ [ 'baz' ], [ 'ahahahahha' ] ],
            ],
        ];
    }
 
    public function testConstructorParams( $expected, $args ) {
        $msg = new Message( 'imasomething' );
 
        $returned = call_user_func_array( [ $msg, 'params' ], $args );
 
        $this->assertSame( $msg, $returned );
        $this->assertSame( $expected, $msg->getParams() );
    }
 
    public static function provideConstructorLanguage() {
        return [
            [ 'foo', [ 'bar' ], 'en' ],
            [ 'foo', [ 'bar' ], 'de' ]
        ];
    }
 
    public function testConstructorLanguage( $key, $params, $languageCode ) {
        $language = Language::factory( $languageCode );
        $message = new Message( $key, $params, $language );
 
        $this->assertEquals( $language, $message->getLanguage() );
    }
 
    public static function provideKeys() {
        return [
            'string' => [
                'key' => 'mainpage',
                'expected' => [ 'mainpage' ],
            ],
            'single' => [
                'key' => [ 'mainpage' ],
                'expected' => [ 'mainpage' ],
            ],
            'multi' => [
                'key' => [ 'mainpage-foo', 'mainpage-bar', 'mainpage' ],
                'expected' => [ 'mainpage-foo', 'mainpage-bar', 'mainpage' ],
            ],
            'empty' => [
                'key' => [],
                'expected' => null,
                'exception' => 'InvalidArgumentException',
            ],
            'null' => [
                'key' => null,
                'expected' => null,
                'exception' => 'InvalidArgumentException',
            ],
            'bad type' => [
                'key' => 123,
                'expected' => null,
                'exception' => 'InvalidArgumentException',
            ],
        ];
    }
 
    public function testKeys( $key, $expected, $exception = null ) {
        if ( $exception ) {
            $this->setExpectedException( $exception );
        }
 
        $msg = new Message( $key );
        $this->assertContains( $msg->getKey(), $expected );
        $this->assertSame( $expected, $msg->getKeysToTry() );
        $this->assertSame( count( $expected ) > 1, $msg->isMultiKey() );
    }
 
    public function testWfMessage() {
        $this->assertInstanceOf( Message::class, wfMessage( 'mainpage' ) );
        $this->assertInstanceOf( Message::class, wfMessage( 'i-dont-exist-evar' ) );
    }
 
    public function testNewFromKey() {
        $this->assertInstanceOf( Message::class, Message::newFromKey( 'mainpage' ) );
        $this->assertInstanceOf( Message::class, Message::newFromKey( 'i-dont-exist-evar' ) );
    }
 
    public function testWfMessageParams() {
        $this->assertSame( 'Return to $1.', wfMessage( 'returnto' )->text() );
        $this->assertSame( 'Return to $1.', wfMessage( 'returnto', [] )->text() );
        $this->assertSame(
            'Return to 1,024.',
            wfMessage( 'returnto', Message::numParam( 1024 ) )->text()
        );
        $this->assertSame(
            'Return to 1,024.',
            wfMessage( 'returnto', [ Message::numParam( 1024 ) ] )->text()
        );
        $this->assertSame(
            'You have foo (bar).',
            wfMessage( 'youhavenewmessages', 'foo', 'bar' )->text()
        );
        $this->assertSame(
            'You have foo (bar).',
            wfMessage( 'youhavenewmessages', [ 'foo', 'bar' ] )->text()
        );
        $this->assertSame(
            'You have 1,024 (bar).',
            wfMessage(
                'youhavenewmessages',
                Message::numParam( 1024 ), 'bar'
            )->text()
        );
        $this->assertSame(
            'You have foo (2,048).',
            wfMessage(
                'youhavenewmessages',
                'foo', Message::numParam( 2048 )
            )->text()
        );
        $this->assertSame(
            'You have 1,024 (2,048).',
            wfMessage(
                'youhavenewmessages',
                [ Message::numParam( 1024 ), Message::numParam( 2048 ) ]
            )->text()
        );
    }
 
    public function testExists() {
        $this->assertTrue( wfMessage( 'mainpage' )->exists() );
        $this->assertTrue( wfMessage( 'mainpage' )->params( [] )->exists() );
        $this->assertTrue( wfMessage( 'mainpage' )->rawParams( 'foo', 123 )->exists() );
        $this->assertFalse( wfMessage( 'i-dont-exist-evar' )->exists() );
        $this->assertFalse( wfMessage( 'i-dont-exist-evar' )->params( [] )->exists() );
        $this->assertFalse( wfMessage( 'i-dont-exist-evar' )->rawParams( 'foo', 123 )->exists() );
    }
 
    public function testToStringKey() {
        $this->assertSame( 'Main Page', wfMessage( 'mainpage' )->text() );
        $this->assertSame( '⧼i-dont-exist-evar⧽', wfMessage( 'i-dont-exist-evar' )->text() );
        $this->assertSame( '⧼i&lt;dont&gt;exist-evar⧽', wfMessage( 'i<dont>exist-evar' )->text() );
        $this->assertSame( '⧼i-dont-exist-evar⧽', wfMessage( 'i-dont-exist-evar' )->plain() );
        $this->assertSame( '⧼i&lt;dont&gt;exist-evar⧽', wfMessage( 'i<dont>exist-evar' )->plain() );
        $this->assertSame( '⧼i-dont-exist-evar⧽', wfMessage( 'i-dont-exist-evar' )->escaped() );
        $this->assertSame(
            '⧼i&lt;dont&gt;exist-evar⧽',
            wfMessage( 'i<dont>exist-evar' )->escaped()
        );
    }
 
    public static function provideToString() {
        return [
            // key, transformation, transformed, transformed implicitly
            [ 'mainpage', 'plain', 'Main Page', 'Main Page' ],
            [ 'i-dont-exist-evar', 'plain', '⧼i-dont-exist-evar⧽', '⧼i-dont-exist-evar⧽' ],
            [ 'i-dont-exist-evar', 'escaped', '⧼i-dont-exist-evar⧽', '⧼i-dont-exist-evar⧽' ],
            [ 'script>alert(1)</script', 'escaped', '⧼script&gt;alert(1)&lt;/script⧽',
                '⧼script&gt;alert(1)&lt;/script⧽' ],
            [ 'script>alert(1)</script', 'plain', '⧼script&gt;alert(1)&lt;/script⧽',
                '⧼script&gt;alert(1)&lt;/script⧽' ],
        ];
    }
 
    public function testToString( $key, $format, $expect, $expectImplicit ) {
        $msg = new Message( $key );
        $this->assertSame( $expect, $msg->$format() );
        $this->assertSame( $expect, $msg->toString(), 'toString is unaffected by previous call' );
        $this->assertSame( $expectImplicit, $msg->__toString() );
        $this->assertSame( $expect, $msg->toString(), 'toString is unaffected by __toString' );
    }
 
    public static function provideToString_raw() {
        return [
            [ '<span>foo</span>', 'parse', '<span>foo</span>', '<span>foo</span>' ],
            [ '<span>foo</span>', 'escaped', '&lt;span&gt;foo&lt;/span&gt;',
                '<span>foo</span>' ],
            [ '<span>foo</span>', 'plain', '<span>foo</span>', '<span>foo</span>' ],
            [ '<script>alert(1)</script>', 'parse', '&lt;script&gt;alert(1)&lt;/script&gt;',
                '&lt;script&gt;alert(1)&lt;/script&gt;' ],
            [ '<script>alert(1)</script>', 'escaped', '&lt;script&gt;alert(1)&lt;/script&gt;',
                '&lt;script&gt;alert(1)&lt;/script&gt;' ],
            [ '<script>alert(1)</script>', 'plain', '<script>alert(1)</script>',
                '&lt;script&gt;alert(1)&lt;/script&gt;' ],
        ];
    }
 
    public function testToString_raw( $message, $format, $expect, $expectImplicit ) {
        // make the message behave like RawMessage and use the key as-is
        $msg = $this->getMockBuilder( Message::class )->setMethods( [ 'fetchMessage' ] )
            ->disableOriginalConstructor()
            ->getMock();
        $msg->expects( $this->any() )->method( 'fetchMessage' )->willReturn( $message );
        $this->assertSame( $expect, $msg->$format() );
        $this->assertSame( $expect, $msg->toString(), 'toString is unaffected by previous call' );
        $this->assertSame( $expectImplicit, $msg->__toString() );
        $this->assertSame( $expect, $msg->toString(), 'toString is unaffected by __toString' );
    }
 
    public function testInLanguage() {
        $this->assertSame( 'Main Page', wfMessage( 'mainpage' )->inLanguage( 'en' )->text() );
        $this->assertSame( 'Заглавная страница',
            wfMessage( 'mainpage' )->inLanguage( 'ru' )->text() );
 
        // NOTE: make sure internal caching of the message text is reset appropriately
        $msg = wfMessage( 'mainpage' );
        $this->assertSame( 'Main Page', $msg->inLanguage( Language::factory( 'en' ) )->text() );
        $this->assertSame(
            'Заглавная страница',
            $msg->inLanguage( Language::factory( 'ru' ) )->text()
        );
    }
 
    public function testRawParams() {
        $this->assertSame(
            '(Заглавная страница)',
            wfMessage( 'parentheses', 'Заглавная страница' )->plain()
        );
        $this->assertSame(
            '(Заглавная страница $1)',
            wfMessage( 'parentheses', 'Заглавная страница $1' )->plain()
        );
        $this->assertSame(
            '(Заглавная страница)',
            wfMessage( 'parentheses' )->rawParams( 'Заглавная страница' )->plain()
        );
        $this->assertSame(
            '(Заглавная страница $1)',
            wfMessage( 'parentheses' )->rawParams( 'Заглавная страница $1' )->plain()
        );
    }
 
    public function testRawMessage() {
        $msg = new RawMessage( 'example &' );
        $this->assertSame( 'example &', $msg->plain() );
        $this->assertSame( 'example &amp;', $msg->escaped() );
    }
 
    public function testRawHtmlInMsg() {
        global $wgParserConf;
        $this->setMwGlobals( 'wgRawHtml', true );
        // We have to reset the core hook registration.
        // to register the html hook
        MessageCache::destroyInstance();
        $this->setMwGlobals( 'wgParser',
            ObjectFactory::constructClassInstance( $wgParserConf['class'], [ $wgParserConf ] )
        );
 
        $msg = new RawMessage( '<html><script>alert("xss")</script></html>' );
        $txt = '<span class="error">&lt;html&gt; tags cannot be' .
            ' used outside of normal pages.</span>';
        $this->assertSame( $txt, $msg->parse() );
    }
 
    public function testReplaceManyParams() {
        $msg = new RawMessage( '$1$2$3$4$5$6$7$8$9$10$11$12' );
        // One less than above has placeholders
        $params = [ 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k' ];
        $this->assertSame(
            'abcdefghijka2',
            $msg->params( $params )->plain(),
            'Params > 9 are replaced correctly'
        );
 
        $msg = new RawMessage( 'Params$*' );
        $params = [ 'ab', 'bc', 'cd' ];
        $this->assertSame(
            'Params: ab, bc, cd',
            $msg->params( $params )->text()
        );
    }
 
    public function testNumParams() {
        $lang = Language::factory( 'en' );
        $msg = new RawMessage( '$1' );
 
        $this->assertSame(
            $lang->formatNum( 123456.789 ),
            $msg->inLanguage( $lang )->numParams( 123456.789 )->plain(),
            'numParams is handled correctly'
        );
    }
 
    public function testDurationParams() {
        $lang = Language::factory( 'en' );
        $msg = new RawMessage( '$1' );
 
        $this->assertSame(
            $lang->formatDuration( 1234 ),
            $msg->inLanguage( $lang )->durationParams( 1234 )->plain(),
            'durationParams is handled correctly'
        );
    }
 
    public function testExpiryParams() {
        $lang = Language::factory( 'en' );
        $msg = new RawMessage( '$1' );
 
        $this->assertSame(
            $lang->formatExpiry( wfTimestampNow() ),
            $msg->inLanguage( $lang )->expiryParams( wfTimestampNow() )->plain(),
            'expiryParams is handled correctly'
        );
    }
 
    public function testTimeperiodParams() {
        $lang = Language::factory( 'en' );
        $msg = new RawMessage( '$1' );
 
        $this->assertSame(
            $lang->formatTimePeriod( 1234 ),
            $msg->inLanguage( $lang )->timeperiodParams( 1234 )->plain(),
            'timeperiodParams is handled correctly'
        );
    }
 
    public function testSizeParams() {
        $lang = Language::factory( 'en' );
        $msg = new RawMessage( '$1' );
 
        $this->assertSame(
            $lang->formatSize( 123456 ),
            $msg->inLanguage( $lang )->sizeParams( 123456 )->plain(),
            'sizeParams is handled correctly'
        );
    }
 
    public function testBitrateParams() {
        $lang = Language::factory( 'en' );
        $msg = new RawMessage( '$1' );
 
        $this->assertSame(
            $lang->formatBitrate( 123456 ),
            $msg->inLanguage( $lang )->bitrateParams( 123456 )->plain(),
            'bitrateParams is handled correctly'
        );
    }
 
    public static function providePlaintextParams() {
        return [
            [
                'one $2 <div>foo</div> [[Bar]] {{Baz}} &lt;',
                'plain',
            ],
 
            [
                // expect
                'one $2 <div>foo</div> [[Bar]] {{Baz}} &lt;',
                // format
                'text',
            ],
            [
                'one $2 &lt;div&gt;foo&lt;/div&gt; [[Bar]] {{Baz}} &amp;lt;',
                'escaped',
            ],
 
            [
                'one $2 &lt;div&gt;foo&lt;/div&gt; [[Bar]] {{Baz}} &amp;lt;',
                'parse',
            ],
 
            [
                "<p>one $2 &lt;div&gt;foo&lt;/div&gt; [[Bar]] {{Baz}} &amp;lt;\n</p>",
                'parseAsBlock',
            ],
        ];
    }
 
    public function testPlaintextParams( $expect, $format ) {
        $lang = Language::factory( 'en' );
 
        $msg = new RawMessage( '$1 $2' );
        $params = [
            'one $2',
            '<div>foo</div> [[Bar]] {{Baz}} &lt;',
        ];
        $this->assertSame(
            $expect,
            $msg->inLanguage( $lang )->plaintextParams( $params )->$format(),
            "Fail formatting for $format"
        );
    }
 
    public static function provideListParam() {
        $lang = Language::factory( 'de' );
        $msg1 = new Message( 'mainpage', [], $lang );
        $msg2 = new RawMessage( "''link''", [], $lang );
 
        return [
            'Simple comma list' => [
                [ 'a', 'b', 'c' ],
                'comma',
                'text',
                'a, b, c'
            ],
 
            'Simple semicolon list' => [
                [ 'a', 'b', 'c' ],
                'semicolon',
                'text',
                'a; b; c'
            ],
 
            'Simple pipe list' => [
                [ 'a', 'b', 'c' ],
                'pipe',
                'text',
                'a | b | c'
            ],
 
            'Simple text list' => [
                [ 'a', 'b', 'c' ],
                'text',
                'text',
                'a, b and c'
            ],
 
            'Empty list' => [
                [],
                'comma',
                'text',
                ''
            ],
 
            'List with all "before" params, ->text()' => [
                [ "''link''", Message::numParam( 12345678 ) ],
                'semicolon',
                'text',
                '\'\'link\'\'; 12,345,678'
            ],
 
            'List with all "before" params, ->parse()' => [
                [ "''link''", Message::numParam( 12345678 ) ],
                'semicolon',
                'parse',
                '<i>link</i>; 12,345,678'
            ],
 
            'List with all "after" params, ->text()' => [
                [ $msg1, $msg2, Message::rawParam( '[[foo]]' ) ],
                'semicolon',
                'text',
                'Main Page; \'\'link\'\'; [[foo]]'
            ],
 
            'List with all "after" params, ->parse()' => [
                [ $msg1, $msg2, Message::rawParam( '[[foo]]' ) ],
                'semicolon',
                'parse',
                'Main Page; <i>link</i>; [[foo]]'
            ],
 
            'List with both "before" and "after" params, ->text()' => [
                [ $msg1, $msg2, Message::rawParam( '[[foo]]' ), "''link''", Message::numParam( 12345678 ) ],
                'semicolon',
                'text',
                'Main Page; \'\'link\'\'; [[foo]]; \'\'link\'\'; 12,345,678'
            ],
 
            'List with both "before" and "after" params, ->parse()' => [
                [ $msg1, $msg2, Message::rawParam( '[[foo]]' ), "''link''", Message::numParam( 12345678 ) ],
                'semicolon',
                'parse',
                'Main Page; <i>link</i>; [[foo]]; <i>link</i>; 12,345,678'
            ],
        ];
    }
 
    public function testListParam( $list, $type, $format, $expect ) {
        $lang = Language::factory( 'en' );
 
        $msg = new RawMessage( '$1' );
        $msg->params( [ Message::listParam( $list, $type ) ] );
        $this->assertEquals(
            $expect,
            $msg->inLanguage( $lang )->$format()
        );
    }
 
    public function testMessageAsParam() {
        $this->setMwGlobals( [
            'wgScript' => '/wiki/index.php',
            'wgArticlePath' => '/wiki/$1',
        ] );
 
        $msg = new Message( 'returnto', [
            new Message( 'apihelp-link', [
                'foo', new Message( 'mainpage', [], Language::factory( 'en' ) )
            ], Language::factory( 'de' ) )
        ], Language::factory( 'es' ) );
 
        $this->assertEquals(
            'Volver a [[Special:ApiHelp/foo|Página principal]].',
            $msg->text(),
            'Process with ->text()'
        );
        $this->assertEquals(
            '<p>Volver a <a href="/wiki/Special:ApiHelp/foo" title="Special:ApiHelp/foo">Página '
                . "principal</a>.\n</p>",
            $msg->parseAsBlock(),
            'Process with ->parseAsBlock()'
        );
    }
 
    public static function provideParser() {
        return [
            [
                "''&'' <x><!-- x -->",
                'plain',
            ],
 
            [
                "''&'' <x><!-- x -->",
                'text',
            ],
            [
                '<i>&amp;</i> &lt;x&gt;',
                'parse',
            ],
 
            [
                "<p><i>&amp;</i> &lt;x&gt;\n</p>",
                'parseAsBlock',
            ],
        ];
    }
 
    public function testParser( $expect, $format ) {
        $msg = new RawMessage( "''&'' <x><!-- x -->" );
        $this->assertSame(
            $expect,
            $msg->inLanguage( 'en' )->$format()
        );
    }
 
    public function testInContentLanguage() {
        $this->setUserLang( 'fr' );
 
        // NOTE: make sure internal caching of the message text is reset appropriately
        $msg = wfMessage( 'mainpage' );
        $this->assertSame( 'Hauptseite', $msg->inLanguage( 'de' )->plain(), "inLanguage( 'de' )" );
        $this->assertSame( 'Main Page', $msg->inContentLanguage()->plain(), "inContentLanguage()" );
        $this->assertSame( 'Accueil', $msg->inLanguage( 'fr' )->plain(), "inLanguage( 'fr' )" );
    }
 
    public function testInContentLanguageOverride() {
        $this->setMwGlobals( [
            'wgForceUIMsgAsContentMsg' => [ 'mainpage' ],
        ] );
        $this->setUserLang( 'fr' );
 
        // NOTE: make sure internal caching of the message text is reset appropriately.
        // NOTE: wgForceUIMsgAsContentMsg forces the messages *current* language to be used.
        $msg = wfMessage( 'mainpage' );
        $this->assertSame(
            'Accueil',
            $msg->inContentLanguage()->plain(),
            'inContentLanguage() with ForceUIMsg override enabled'
        );
        $this->assertSame( 'Main Page', $msg->inLanguage( 'en' )->plain(), "inLanguage( 'en' )" );
        $this->assertSame(
            'Main Page',
            $msg->inContentLanguage()->plain(),
            'inContentLanguage() with ForceUIMsg override enabled'
        );
        $this->assertSame( 'Hauptseite', $msg->inLanguage( 'de' )->plain(), "inLanguage( 'de' )" );
    }
 
    public function testInLanguageThrows() {
        wfMessage( 'foo' )->inLanguage( 123 );
    }
 
    public function testSerialization() {
        $msg = new Message( 'parentheses' );
        $msg->rawParams( '<a>foo</a>' );
        $msg->title( Title::newFromText( 'Testing' ) );
        $this->assertSame( '(<a>foo</a>)', $msg->parse(), 'Sanity check' );
        $msg = unserialize( serialize( $msg ) );
        $this->assertSame( '(<a>foo</a>)', $msg->parse() );
        $title = TestingAccessWrapper::newFromObject( $msg )->title;
        $this->assertInstanceOf( Title::class, $title );
        $this->assertSame( 'Testing', $title->getFullText() );
 
        $msg = new Message( 'mainpage' );
        $msg->inLanguage( 'de' );
        $this->assertSame( 'Hauptseite', $msg->plain(), 'Sanity check' );
        $msg = unserialize( serialize( $msg ) );
        $this->assertSame( 'Hauptseite', $msg->plain() );
    }
 
    public function testNewFromSpecifier( $value, $expectedText ) {
        $message = Message::newFromSpecifier( $value );
        $this->assertInstanceOf( Message::class, $message );
        if ( $value instanceof Message ) {
            $this->assertInstanceOf( get_class( $value ), $message );
            $this->assertEquals( $value, $message );
        }
        $this->assertSame( $expectedText, $message->text() );
    }
 
    public function provideNewFromSpecifier() {
        $messageSpecifier = $this->getMockForAbstractClass( MessageSpecifier::class );
        $messageSpecifier->expects( $this->any() )->method( 'getKey' )->willReturn( 'mainpage' );
        $messageSpecifier->expects( $this->any() )->method( 'getParams' )->willReturn( [] );
 
        return [
            'string' => [ 'mainpage', 'Main Page' ],
            'array' => [ [ 'youhavenewmessages', 'foo', 'bar' ], 'You have foo (bar).' ],
            'Message' => [ new Message( 'youhavenewmessages', [ 'foo', 'bar' ] ), 'You have foo (bar).' ],
            'RawMessage' => [ new RawMessage( 'foo ($1)', [ 'bar' ] ), 'foo (bar)' ],
            'ApiMessage' => [ new ApiMessage( [ 'mainpage' ], 'code', [ 'data' ] ), 'Main Page' ],
            'MessageSpecifier' => [ $messageSpecifier, 'Main Page' ],
            'nested RawMessage' => [ [ new RawMessage( 'foo ($1)', [ 'bar' ] ) ], 'foo (bar)' ],
        ];
    }
}