3 class MessageTest
extends MediaWikiLangTestCase
{
5 protected function setUp() {
8 $this->setMwGlobals( array(
9 'wgLang' => Language
::factory( 'en' ),
10 'wgForceUIMsgAsContentMsg' => array(),
15 * @covers Message::__construct
16 * @dataProvider provideConstructor
18 public function testConstructor( $expectedLang, $key, $params, $language ) {
19 $reflection = new ReflectionClass( 'Message' );
21 $keyProperty = $reflection->getProperty( 'key' );
22 $keyProperty->setAccessible( true );
24 $paramsProperty = $reflection->getProperty( 'parameters' );
25 $paramsProperty->setAccessible( true );
27 $langProperty = $reflection->getProperty( 'language' );
28 $langProperty->setAccessible( true );
30 $message = new Message( $key, $params, $language );
32 $this->assertEquals( $key, $keyProperty->getValue( $message ) );
33 $this->assertEquals( $params, $paramsProperty->getValue( $message ) );
34 $this->assertEquals( $expectedLang, $langProperty->getValue( $message ) );
37 public static function provideConstructor() {
38 $langDe = Language
::factory( 'de' );
39 $langEn = Language
::factory( 'en' );
42 array( $langDe, 'foo', array(), $langDe ),
43 array( $langDe, 'foo', array( 'bar' ), $langDe ),
44 array( $langEn, 'foo', array( 'bar' ), null )
48 public static function provideTestParams() {
51 array( array( 'foo' ), 'foo' ),
52 array( array( 'foo', 'bar' ), 'foo', 'bar' ),
53 array( array( 'baz' ), array( 'baz' ) ),
54 array( array( 'baz', 'foo' ), array( 'baz', 'foo' ) ),
55 array( array( 'baz', 'foo' ), array( 'baz', 'foo' ), 'hhh' ),
56 array( array( 'baz', 'foo' ), array( 'baz', 'foo' ), 'hhh', array( 'ahahahahha' ) ),
57 array( array( 'baz', 'foo' ), array( 'baz', 'foo' ), array( 'ahahahahha' ) ),
58 array( array( 'baz' ), array( 'baz' ), array( 'ahahahahha' ) ),
62 public function getLanguageProvider() {
64 array( 'foo', array( 'bar' ), 'en' ),
65 array( 'foo', array( 'bar' ), 'de' )
70 * @covers Message::getLanguage
71 * @dataProvider getLanguageProvider
73 public function testGetLanguageCode( $key, $params, $languageCode ) {
74 $language = Language
::factory( $languageCode );
75 $message = new Message( $key, $params, $language );
77 $this->assertEquals( $language, $message->getLanguage() );
81 * @covers Message::params
82 * @dataProvider provideTestParams
84 public function testParams( $expected ) {
85 $msg = new Message( 'imasomething' );
87 $returned = call_user_func_array( array( $msg, 'params' ), array_slice( func_get_args(), 1 ) );
89 $this->assertSame( $msg, $returned );
90 $this->assertEquals( $expected, $msg->getParams() );
94 * @covers Message::exists
96 public function testExists() {
97 $this->assertTrue( wfMessage( 'mainpage' )->exists() );
98 $this->assertTrue( wfMessage( 'mainpage' )->params( array() )->exists() );
99 $this->assertTrue( wfMessage( 'mainpage' )->rawParams( 'foo', 123 )->exists() );
100 $this->assertFalse( wfMessage( 'i-dont-exist-evar' )->exists() );
101 $this->assertFalse( wfMessage( 'i-dont-exist-evar' )->params( array() )->exists() );
102 $this->assertFalse( wfMessage( 'i-dont-exist-evar' )->rawParams( 'foo', 123 )->exists() );
106 * @covers Message::__construct
108 public function testKey() {
109 $this->assertInstanceOf( 'Message', wfMessage( 'mainpage' ) );
110 $this->assertInstanceOf( 'Message', wfMessage( 'i-dont-exist-evar' ) );
111 $this->assertEquals( 'Main Page', wfMessage( 'mainpage' )->text() );
112 $this->assertEquals( '<i-dont-exist-evar>', wfMessage( 'i-dont-exist-evar' )->text() );
113 $this->assertEquals( '<i-dont-exist-evar>', wfMessage( 'i-dont-exist-evar' )->plain() );
114 $this->assertEquals( '<i-dont-exist-evar>', wfMessage( 'i-dont-exist-evar' )->escaped() );
118 * @covers Message::inLanguage
120 public function testInLanguage() {
121 $this->assertEquals( 'Main Page', wfMessage( 'mainpage' )->inLanguage( 'en' )->text() );
122 $this->assertEquals( 'Заглавная страница',
123 wfMessage( 'mainpage' )->inLanguage( 'ru' )->text() );
125 // NOTE: make sure internal caching of the message text is reset appropriately
126 $msg = wfMessage( 'mainpage' );
127 $this->assertEquals( 'Main Page', $msg->inLanguage( Language
::factory( 'en' ) )->text() );
129 'Заглавная страница',
130 $msg->inLanguage( Language
::factory( 'ru' ) )->text()
135 * @covers Message::__construct
137 public function testMessageParams() {
138 $this->assertEquals( 'Return to $1.', wfMessage( 'returnto' )->text() );
139 $this->assertEquals( 'Return to $1.', wfMessage( 'returnto', array() )->text() );
141 'You have foo (bar).',
142 wfMessage( 'youhavenewmessages', 'foo', 'bar' )->text()
145 'You have foo (bar).',
146 wfMessage( 'youhavenewmessages', array( 'foo', 'bar' ) )->text()
151 * @covers Message::__construct
152 * @covers Message::rawParams
154 public function testMessageParamSubstitution() {
156 '(Заглавная страница)',
157 wfMessage( 'parentheses', 'Заглавная страница' )->plain()
160 '(Заглавная страница $1)',
161 wfMessage( 'parentheses', 'Заглавная страница $1' )->plain()
164 '(Заглавная страница)',
165 wfMessage( 'parentheses' )->rawParams( 'Заглавная страница' )->plain()
168 '(Заглавная страница $1)',
169 wfMessage( 'parentheses' )->rawParams( 'Заглавная страница $1' )->plain()
174 * @covers Message::__construct
175 * @covers Message::params
177 public function testDeliciouslyManyParams() {
178 $msg = new RawMessage( '$1$2$3$4$5$6$7$8$9$10$11$12' );
179 // One less than above has placeholders
180 $params = array( 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k' );
183 $msg->params( $params )->plain(),
184 'Params > 9 are replaced correctly'
189 * @covers Message::numParams
191 public function testMessageNumParams() {
192 $lang = Language
::factory( 'en' );
193 $msg = new RawMessage( '$1' );
196 $lang->formatNum( 123456.789 ),
197 $msg->inLanguage( $lang )->numParams( 123456.789 )->plain(),
198 'numParams is handled correctly'
203 * @covers Message::durationParams
205 public function testMessageDurationParams() {
206 $lang = Language
::factory( 'en' );
207 $msg = new RawMessage( '$1' );
210 $lang->formatDuration( 1234 ),
211 $msg->inLanguage( $lang )->durationParams( 1234 )->plain(),
212 'durationParams is handled correctly'
217 * FIXME: This should not need database, but Language#formatExpiry does (bug 55912)
219 * @covers Message::expiryParams
221 public function testMessageExpiryParams() {
222 $lang = Language
::factory( 'en' );
223 $msg = new RawMessage( '$1' );
226 $lang->formatExpiry( wfTimestampNow() ),
227 $msg->inLanguage( $lang )->expiryParams( wfTimestampNow() )->plain(),
228 'expiryParams is handled correctly'
233 * @covers Message::timeperiodParams
235 public function testMessageTimeperiodParams() {
236 $lang = Language
::factory( 'en' );
237 $msg = new RawMessage( '$1' );
240 $lang->formatTimePeriod( 1234 ),
241 $msg->inLanguage( $lang )->timeperiodParams( 1234 )->plain(),
242 'timeperiodParams is handled correctly'
247 * @covers Message::sizeParams
249 public function testMessageSizeParams() {
250 $lang = Language
::factory( 'en' );
251 $msg = new RawMessage( '$1' );
254 $lang->formatSize( 123456 ),
255 $msg->inLanguage( $lang )->sizeParams( 123456 )->plain(),
256 'sizeParams is handled correctly'
261 * @covers Message::bitrateParams
263 public function testMessageBitrateParams() {
264 $lang = Language
::factory( 'en' );
265 $msg = new RawMessage( '$1' );
268 $lang->formatBitrate( 123456 ),
269 $msg->inLanguage( $lang )->bitrateParams( 123456 )->plain(),
270 'bitrateParams is handled correctly'
275 * @covers Message::inContentLanguage
277 public function testInContentLanguage() {
278 $this->setMwGlobals( 'wgLang', Language
::factory( 'fr' ) );
280 // NOTE: make sure internal caching of the message text is reset appropriately
281 $msg = wfMessage( 'mainpage' );
282 $this->assertEquals( 'Hauptseite', $msg->inLanguage( 'de' )->plain(), "inLanguage( 'de' )" );
283 $this->assertEquals( 'Main Page', $msg->inContentLanguage()->plain(), "inContentLanguage()" );
284 $this->assertEquals( 'Accueil', $msg->inLanguage( 'fr' )->plain(), "inLanguage( 'fr' )" );
288 * @covers Message::inContentLanguage
290 public function testInContentLanguageOverride() {
291 $this->setMwGlobals( array(
292 'wgLang' => Language
::factory( 'fr' ),
293 'wgForceUIMsgAsContentMsg' => array( 'mainpage' ),
296 // NOTE: make sure internal caching of the message text is reset appropriately.
297 // NOTE: wgForceUIMsgAsContentMsg forces the messages *current* language to be used.
298 $msg = wfMessage( 'mainpage' );
301 $msg->inContentLanguage()->plain(),
302 'inContentLanguage() with ForceUIMsg override enabled'
304 $this->assertEquals( 'Main Page', $msg->inLanguage( 'en' )->plain(), "inLanguage( 'en' )" );
307 $msg->inContentLanguage()->plain(),
308 'inContentLanguage() with ForceUIMsg override enabled'
310 $this->assertEquals( 'Hauptseite', $msg->inLanguage( 'de' )->plain(), "inLanguage( 'de' )" );
314 * @expectedException MWException
315 * @covers Message::inLanguage
317 public function testInLanguageThrows() {
318 wfMessage( 'foo' )->inLanguage( 123 );
321 public function keyProvider() {
325 'expected' => array( 'mainpage' ),
328 'key' => array( 'mainpage' ),
329 'expected' => array( 'mainpage' ),
332 'key' => array( 'mainpage-foo', 'mainpage-bar', 'mainpage' ),
333 'expected' => array( 'mainpage-foo', 'mainpage-bar', 'mainpage' ),
338 'exception' => 'InvalidArgumentException',
343 'exception' => 'InvalidArgumentException',
348 'exception' => 'InvalidArgumentException',
354 * @dataProvider keyProvider()
356 * @covers Message::getKey
358 public function testGetKey( $key, $expected, $exception = null ) {
360 $this->setExpectedException( $exception );
363 $msg = new Message( $key );
364 $this->assertEquals( $expected, $msg->getKeysToTry() );
365 $this->assertEquals( count( $expected ) > 1, $msg->isMultiKey() );
366 $this->assertContains( $msg->getKey(), $expected );