dépôts / lhc / web / wiklou.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
history | raw | HEAD
Add OutputPage::wrapWikiTextAsInterface() to safely wrap wikitext
[lhc/web/wiklou.git] / tests / phpunit / includes / OutputPageTest.php
1 <?php
2
3 use Wikimedia\TestingAccessWrapper;
4
5 /**
6 * @author Matthew Flaschen
7 *
8 * @group Database
9 * @group Output
10 */
11 class OutputPageTest extends MediaWikiTestCase {
12 const SCREEN_MEDIA_QUERY = 'screen and (min-width: 982px)';
13 const SCREEN_ONLY_MEDIA_QUERY = 'only screen and (min-width: 982px)';
14
15 // Ensure that we don't affect the global ResourceLoader state.
16 protected function setUp() {
17 parent::setUp();
18 ResourceLoader::clearCache();
19 }
20 protected function tearDown() {
21 parent::tearDown();
22 ResourceLoader::clearCache();
23 }
24
25 /**
26 * @dataProvider provideRedirect
27 *
28 * @covers OutputPage::__construct
29 * @covers OutputPage::redirect
30 * @covers OutputPage::getRedirect
31 */
32 public function testRedirect( $url, $code = null ) {
33 $op = $this->newInstance();
34 if ( isset( $code ) ) {
35 $op->redirect( $url, $code );
36 } else {
37 $op->redirect( $url );
38 }
39 $expectedUrl = str_replace( "\n", '', $url );
40 $this->assertSame( $expectedUrl, $op->getRedirect() );
41 $this->assertSame( $expectedUrl, $op->mRedirect );
42 $this->assertSame( $code ?? '302', $op->mRedirectCode );
43 }
44
45 public function provideRedirect() {
46 return [
47 [ 'http://example.com' ],
48 [ 'http://example.com', '400' ],
49 [ 'http://example.com', 'squirrels!!!' ],
50 [ "a\nb" ],
51 ];
52 }
53
54 /**
55 * @covers OutputPage::setCopyrightUrl
56 * @covers OutputPage::getHeadLinksArray
57 */
58 public function testSetCopyrightUrl() {
59 $op = $this->newInstance();
60 $op->setCopyrightUrl( 'http://example.com' );
61
62 $this->assertSame(
63 Html::element( 'link', [ 'rel' => 'license', 'href' => 'http://example.com' ] ),
64 $op->getHeadLinksArray()['copyright']
65 );
66 }
67
68 // @todo How to test setStatusCode?
69
70 /**
71 * @covers OutputPage::addMeta
72 * @covers OutputPage::getMetaTags
73 * @covers OutputPage::getHeadLinksArray
74 */
75 public function testMetaTags() {
76 $op = $this->newInstance();
77 $op->addMeta( 'http:expires', '0' );
78 $op->addMeta( 'keywords', 'first' );
79 $op->addMeta( 'keywords', 'second' );
80 $op->addMeta( 'og:title', 'Ta-duh' );
81
82 $expected = [
83 [ 'http:expires', '0' ],
84 [ 'keywords', 'first' ],
85 [ 'keywords', 'second' ],
86 [ 'og:title', 'Ta-duh' ],
87 ];
88 $this->assertSame( $expected, $op->getMetaTags() );
89
90 $links = $op->getHeadLinksArray();
91 $this->assertContains( '<meta http-equiv="expires" content="0"/>', $links );
92 $this->assertContains( '<meta name="keywords" content="first"/>', $links );
93 $this->assertContains( '<meta name="keywords" content="second"/>', $links );
94 $this->assertContains( '<meta property="og:title" content="Ta-duh"/>', $links );
95 $this->assertArrayNotHasKey( 'meta-robots', $links );
96 }
97
98 /**
99 * @covers OutputPage::addLink
100 * @covers OutputPage::getLinkTags
101 * @covers OutputPage::getHeadLinksArray
102 */
103 public function testAddLink() {
104 $op = $this->newInstance();
105
106 $links = [
107 [],
108 [ 'rel' => 'foo', 'href' => 'http://example.com' ],
109 ];
110
111 foreach ( $links as $link ) {
112 $op->addLink( $link );
113 }
114
115 $this->assertSame( $links, $op->getLinkTags() );
116
117 $result = $op->getHeadLinksArray();
118
119 foreach ( $links as $link ) {
120 $this->assertContains( Html::element( 'link', $link ), $result );
121 }
122 }
123
124 /**
125 * @covers OutputPage::setCanonicalUrl
126 * @covers OutputPage::getCanonicalUrl
127 * @covers OutputPage::getHeadLinksArray
128 */
129 public function testSetCanonicalUrl() {
130 $op = $this->newInstance();
131 $op->setCanonicalUrl( 'http://example.comm' );
132 $op->setCanonicalUrl( 'http://example.com' );
133
134 $this->assertSame( 'http://example.com', $op->getCanonicalUrl() );
135
136 $headLinks = $op->getHeadLinksArray();
137
138 $this->assertContains( Html::element( 'link', [
139 'rel' => 'canonical', 'href' => 'http://example.com'
140 ] ), $headLinks );
141
142 $this->assertNotContains( Html::element( 'link', [
143 'rel' => 'canonical', 'href' => 'http://example.comm'
144 ] ), $headLinks );
145 }
146
147 /**
148 * @covers OutputPage::addScript
149 */
150 public function testAddScript() {
151 $op = $this->newInstance();
152 $op->addScript( 'some random string' );
153
154 $this->assertContains( "\nsome random string\n", "\n" . $op->getBottomScripts() . "\n" );
155 }
156
157 /**
158 * @covers OutputPage::addScriptFile
159 */
160 public function testAddScriptFile() {
161 $op = $this->newInstance();
162 $op->addScriptFile( '/somescript.js' );
163 $op->addScriptFile( '//example.com/somescript.js' );
164
165 $this->assertContains(
166 "\n" . Html::linkedScript( '/somescript.js', $op->getCSPNonce() ) .
167 Html::linkedScript( '//example.com/somescript.js', $op->getCSPNonce() ) . "\n",
168 "\n" . $op->getBottomScripts() . "\n"
169 );
170 }
171
172 /**
173 * Test that addScriptFile() throws due to deprecation.
174 *
175 * @covers OutputPage::addScriptFile
176 */
177 public function testAddDeprecatedScriptFileWarning() {
178 $this->setExpectedException( PHPUnit_Framework_Error_Deprecated::class,
179 'Use of OutputPage::addScriptFile was deprecated in MediaWiki 1.24.' );
180
181 $op = $this->newInstance();
182 $op->addScriptFile( 'ignored-script.js' );
183 }
184
185 /**
186 * Test the actual behavior of the method (in the case where it doesn't throw, e.g., in
187 * production).
188 *
189 * @covers OutputPage::addScriptFile
190 */
191 public function testAddDeprecatedScriptFileNoOp() {
192 $this->hideDeprecated( 'OutputPage::addScriptFile' );
193 $op = $this->newInstance();
194 $op->addScriptFile( 'ignored-script.js' );
195
196 $this->assertNotContains( 'ignored-script.js', '' . $op->getBottomScripts() );
197 }
198
199 /**
200 * @covers OutputPage::addInlineScript
201 */
202 public function testAddInlineScript() {
203 $op = $this->newInstance();
204 $op->addInlineScript( 'let foo = "bar";' );
205 $op->addInlineScript( 'alert( foo );' );
206
207 $this->assertContains(
208 "\n" . Html::inlineScript( "\nlet foo = \"bar\";\n", $op->getCSPNonce() ) . "\n" .
209 Html::inlineScript( "\nalert( foo );\n", $op->getCSPNonce() ) . "\n",
210 "\n" . $op->getBottomScripts() . "\n"
211 );
212 }
213
214 // @todo How to test filterModules(), warnModuleTargetFilter(), getModules(), etc.?
215
216 /**
217 * @covers OutputPage::getTarget
218 * @covers OutputPage::setTarget
219 */
220 public function testSetTarget() {
221 $op = $this->newInstance();
222 $op->setTarget( 'foo' );
223
224 $this->assertSame( 'foo', $op->getTarget() );
225 // @todo What else? Test some actual effect?
226 }
227
228 // @todo How to test addContentOverride(Callback)?
229
230 /**
231 * @covers OutputPage::getHeadItemsArray
232 * @covers OutputPage::addHeadItem
233 * @covers OutputPage::addHeadItems
234 * @covers OutputPage::hasHeadItem
235 */
236 public function testHeadItems() {
237 $op = $this->newInstance();
238 $op->addHeadItem( 'a', 'b' );
239 $op->addHeadItems( [ 'c' => '<d>&amp;', 'e' => 'f', 'a' => 'q' ] );
240 $op->addHeadItem( 'e', 'g' );
241 $op->addHeadItems( 'x' );
242
243 $this->assertSame( [ 'a' => 'q', 'c' => '<d>&amp;', 'e' => 'g', 'x' ],
244 $op->getHeadItemsArray() );
245
246 $this->assertTrue( $op->hasHeadItem( 'a' ) );
247 $this->assertTrue( $op->hasHeadItem( 'c' ) );
248 $this->assertTrue( $op->hasHeadItem( 'e' ) );
249 $this->assertTrue( $op->hasHeadItem( '0' ) );
250
251 $this->assertContains( "\nq\n<d>&amp;\ng\nx\n",
252 '' . $op->headElement( $op->getContext()->getSkin() ) );
253 }
254
255 /**
256 * @covers OutputPage::getHeadItemsArray
257 * @covers OutputPage::addParserOutputMetadata
258 * @covers OutputPage::addParserOutput
259 */
260 public function testHeadItemsParserOutput() {
261 $op = $this->newInstance();
262 $stubPO1 = $this->createParserOutputStub( 'getHeadItems', [ 'a' => 'b' ] );
263 $op->addParserOutputMetadata( $stubPO1 );
264 $stubPO2 = $this->createParserOutputStub( 'getHeadItems',
265 [ 'c' => '<d>&amp;', 'e' => 'f', 'a' => 'q' ] );
266 $op->addParserOutputMetadata( $stubPO2 );
267 $stubPO3 = $this->createParserOutputStub( 'getHeadItems', [ 'e' => 'g' ] );
268 $op->addParserOutput( $stubPO3 );
269 $stubPO4 = $this->createParserOutputStub( 'getHeadItems', [ 'x' ] );
270 $op->addParserOutputMetadata( $stubPO4 );
271
272 $this->assertSame( [ 'a' => 'q', 'c' => '<d>&amp;', 'e' => 'g', 'x' ],
273 $op->getHeadItemsArray() );
274
275 $this->assertTrue( $op->hasHeadItem( 'a' ) );
276 $this->assertTrue( $op->hasHeadItem( 'c' ) );
277 $this->assertTrue( $op->hasHeadItem( 'e' ) );
278 $this->assertTrue( $op->hasHeadItem( '0' ) );
279 $this->assertFalse( $op->hasHeadItem( 'b' ) );
280
281 $this->assertContains( "\nq\n<d>&amp;\ng\nx\n",
282 '' . $op->headElement( $op->getContext()->getSkin() ) );
283 }
284
285 /**
286 * @covers OutputPage::addBodyClasses
287 */
288 public function testAddBodyClasses() {
289 $op = $this->newInstance();
290 $op->addBodyClasses( 'a' );
291 $op->addBodyClasses( 'mediawiki' );
292 $op->addBodyClasses( 'b c' );
293 $op->addBodyClasses( [ 'd', 'e' ] );
294 $op->addBodyClasses( 'a' );
295
296 $this->assertContains( '"a mediawiki b c d e ltr',
297 '' . $op->headElement( $op->getContext()->getSkin() ) );
298 }
299
300 /**
301 * @covers OutputPage::setArticleBodyOnly
302 * @covers OutputPage::getArticleBodyOnly
303 */
304 public function testArticleBodyOnly() {
305 $op = $this->newInstance();
306 $this->assertFalse( $op->getArticleBodyOnly() );
307
308 $op->setArticleBodyOnly( true );
309 $this->assertTrue( $op->getArticleBodyOnly() );
310
311 $op->addHTML( '<b>a</b>' );
312
313 $this->assertSame( '<b>a</b>', $op->output( true ) );
314 }
315
316 /**
317 * @covers OutputPage::setProperty
318 * @covers OutputPage::getProperty
319 */
320 public function testProperties() {
321 $op = $this->newInstance();
322
323 $this->assertNull( $op->getProperty( 'foo' ) );
324
325 $op->setProperty( 'foo', 'bar' );
326 $op->setProperty( 'baz', 'quz' );
327
328 $this->assertSame( 'bar', $op->getProperty( 'foo' ) );
329 $this->assertSame( 'quz', $op->getProperty( 'baz' ) );
330 }
331
332 /**
333 * @dataProvider provideCheckLastModified
334 *
335 * @covers OutputPage::checkLastModified
336 * @covers OutputPage::getCdnCacheEpoch
337 */
338 public function testCheckLastModified(
339 $timestamp, $ifModifiedSince, $expected, $config = [], $callback = null
340 ) {
341 $request = new FauxRequest();
342 if ( $ifModifiedSince ) {
343 if ( is_numeric( $ifModifiedSince ) ) {
344 // Unix timestamp
345 $ifModifiedSince = date( 'D, d M Y H:i:s', $ifModifiedSince ) . ' GMT';
346 }
347 $request->setHeader( 'If-Modified-Since', $ifModifiedSince );
348 }
349
350 if ( !isset( $config['CacheEpoch'] ) ) {
351 // Make sure it's not too recent
352 $config['CacheEpoch'] = '20000101000000';
353 }
354
355 $op = $this->newInstance( $config, $request );
356
357 if ( $callback ) {
358 $callback( $op, $this );
359 }
360
361 // Avoid a complaint about not being able to disable compression
362 Wikimedia\suppressWarnings();
363 try {
364 $this->assertEquals( $expected, $op->checkLastModified( $timestamp ) );
365 } finally {
366 Wikimedia\restoreWarnings();
367 }
368 }
369
370 public function provideCheckLastModified() {
371 $lastModified = time() - 3600;
372 return [
373 'Timestamp 0' =>
374 [ '0', $lastModified, false ],
375 'Timestamp Unix epoch' =>
376 [ '19700101000000', $lastModified, false ],
377 'Timestamp same as If-Modified-Since' =>
378 [ $lastModified, $lastModified, true ],
379 'Timestamp one second after If-Modified-Since' =>
380 [ $lastModified + 1, $lastModified, false ],
381 'No If-Modified-Since' =>
382 [ $lastModified + 1, null, false ],
383 'Malformed If-Modified-Since' =>
384 [ $lastModified + 1, 'GIBBERING WOMBATS !!!', false ],
385 'Non-standard IE-style If-Modified-Since' =>
386 [ $lastModified, date( 'D, d M Y H:i:s', $lastModified ) . ' GMT; length=5202',
387 true ],
388 // @todo Should we fix this behavior to match the spec? Probably no reason to.
389 'If-Modified-Since not per spec but we accept it anyway because strtotime does' =>
390 [ $lastModified, "@$lastModified", true ],
391 '$wgCachePages = false' =>
392 [ $lastModified, $lastModified, false, [ 'CachePages' => false ] ],
393 '$wgCacheEpoch' =>
394 [ $lastModified, $lastModified, false,
395 [ 'CacheEpoch' => wfTimestamp( TS_MW, $lastModified + 1 ) ] ],
396 'Recently-touched user' =>
397 [ $lastModified, $lastModified, false, [],
398 function ( $op ) {
399 $op->getContext()->setUser( $this->getTestUser()->getUser() );
400 } ],
401 'After Squid expiry' =>
402 [ $lastModified, $lastModified, false,
403 [ 'UseSquid' => true, 'SquidMaxage' => 3599 ] ],
404 'Hook allows cache use' =>
405 [ $lastModified + 1, $lastModified, true, [],
406 function ( $op, $that ) {
407 $that->setTemporaryHook( 'OutputPageCheckLastModified',
408 function ( &$modifiedTimes ) {
409 $modifiedTimes = [ 1 ];
410 }
411 );
412 } ],
413 'Hooks prohibits cache use' =>
414 [ $lastModified, $lastModified, false, [],
415 function ( $op, $that ) {
416 $that->setTemporaryHook( 'OutputPageCheckLastModified',
417 function ( &$modifiedTimes ) {
418 $modifiedTimes = [ max( $modifiedTimes ) + 1 ];
419 }
420 );
421 } ],
422 ];
423 }
424
425 /**
426 * @dataProvider provideCdnCacheEpoch
427 *
428 * @covers OutputPage::getCdnCacheEpoch
429 */
430 public function testCdnCacheEpoch( $params ) {
431 $out = TestingAccessWrapper::newFromObject( $this->newInstance() );
432 $reqTime = strtotime( $params['reqTime'] );
433 $pageTime = strtotime( $params['pageTime'] );
434 $actual = max( $pageTime, $out->getCdnCacheEpoch( $reqTime, $params['maxAge'] ) );
435
436 $this->assertEquals(
437 $params['expect'],
438 gmdate( DateTime::ATOM, $actual ),
439 'cdn epoch'
440 );
441 }
442
443 public static function provideCdnCacheEpoch() {
444 $base = [
445 'pageTime' => '2011-04-01T12:00:00+00:00',
446 'maxAge' => 24 * 3600,
447 ];
448 return [
449 'after 1s' => [ $base + [
450 'reqTime' => '2011-04-01T12:00:01+00:00',
451 'expect' => '2011-04-01T12:00:00+00:00',
452 ] ],
453 'after 23h' => [ $base + [
454 'reqTime' => '2011-04-02T11:00:00+00:00',
455 'expect' => '2011-04-01T12:00:00+00:00',
456 ] ],
457 'after 24h and a bit' => [ $base + [
458 'reqTime' => '2011-04-02T12:34:56+00:00',
459 'expect' => '2011-04-01T12:34:56+00:00',
460 ] ],
461 'after a year' => [ $base + [
462 'reqTime' => '2012-05-06T00:12:07+00:00',
463 'expect' => '2012-05-05T00:12:07+00:00',
464 ] ],
465 ];
466 }
467
468 // @todo How to test setLastModified?
469
470 /**
471 * @covers OutputPage::setRobotPolicy
472 * @covers OutputPage::getHeadLinksArray
473 */
474 public function testSetRobotPolicy() {
475 $op = $this->newInstance();
476 $op->setRobotPolicy( 'noindex, nofollow' );
477
478 $links = $op->getHeadLinksArray();
479 $this->assertContains( '<meta name="robots" content="noindex,nofollow"/>', $links );
480 }
481
482 /**
483 * @covers OutputPage::setIndexPolicy
484 * @covers OutputPage::setFollowPolicy
485 * @covers OutputPage::getHeadLinksArray
486 */
487 public function testSetIndexFollowPolicies() {
488 $op = $this->newInstance();
489 $op->setIndexPolicy( 'noindex' );
490 $op->setFollowPolicy( 'nofollow' );
491
492 $links = $op->getHeadLinksArray();
493 $this->assertContains( '<meta name="robots" content="noindex,nofollow"/>', $links );
494 }
495
496 private function extractHTMLTitle( OutputPage $op ) {
497 $html = $op->headElement( $op->getContext()->getSkin() );
498
499 // OutputPage should always output the title in a nice format such that regexes will work
500 // fine. If it doesn't, we'll fail the tests.
501 preg_match_all( '!<title>(.*?)</title>!', $html, $matches );
502
503 $this->assertLessThanOrEqual( 1, count( $matches[1] ), 'More than one <title>!' );
504
505 if ( !count( $matches[1] ) ) {
506 return null;
507 }
508
509 return $matches[1][0];
510 }
511
512 /**
513 * Shorthand for getting the text of a message, in content language.
514 */
515 private static function getMsgText( $op, ...$msgParams ) {
516 return $op->msg( ...$msgParams )->inContentLanguage()->text();
517 }
518
519 /**
520 * @covers OutputPage::setHTMLTitle
521 * @covers OutputPage::getHTMLTitle
522 */
523 public function testHTMLTitle() {
524 $op = $this->newInstance();
525
526 // Default
527 $this->assertSame( '', $op->getHTMLTitle() );
528 $this->assertSame( '', $op->getPageTitle() );
529 $this->assertSame(
530 $this->getMsgText( $op, 'pagetitle', '' ),
531 $this->extractHTMLTitle( $op )
532 );
533
534 // Set to string
535 $op->setHTMLTitle( 'Potatoes will eat me' );
536
537 $this->assertSame( 'Potatoes will eat me', $op->getHTMLTitle() );
538 $this->assertSame( 'Potatoes will eat me', $this->extractHTMLTitle( $op ) );
539 // Shouldn't have changed the page title
540 $this->assertSame( '', $op->getPageTitle() );
541
542 // Set to message
543 $msg = $op->msg( 'mainpage' );
544
545 $op->setHTMLTitle( $msg );
546 $this->assertSame( $msg->text(), $op->getHTMLTitle() );
547 $this->assertSame( $msg->text(), $this->extractHTMLTitle( $op ) );
548 $this->assertSame( '', $op->getPageTitle() );
549 }
550
551 /**
552 * @covers OutputPage::setRedirectedFrom
553 */
554 public function testSetRedirectedFrom() {
555 $op = $this->newInstance();
556
557 $op->setRedirectedFrom( Title::newFromText( 'Talk:Some page' ) );
558 $this->assertSame( 'Talk:Some_page', $op->getJSVars()['wgRedirectedFrom'] );
559 }
560
561 /**
562 * @covers OutputPage::setPageTitle
563 * @covers OutputPage::getPageTitle
564 */
565 public function testPageTitle() {
566 // We don't test the actual HTML output anywhere, because that's up to the skin.
567 $op = $this->newInstance();
568
569 // Test default
570 $this->assertSame( '', $op->getPageTitle() );
571 $this->assertSame( '', $op->getHTMLTitle() );
572
573 // Test set to plain text
574 $op->setPageTitle( 'foobar' );
575
576 $this->assertSame( 'foobar', $op->getPageTitle() );
577 // HTML title should change as well
578 $this->assertSame( $this->getMsgText( $op, 'pagetitle', 'foobar' ), $op->getHTMLTitle() );
579
580 // Test set to text with good and bad HTML. We don't try to be comprehensive here, that
581 // belongs in Sanitizer tests.
582 $op->setPageTitle( '<script>a</script>&amp;<i>b</i>' );
583
584 $this->assertSame( '&lt;script&gt;a&lt;/script&gt;&amp;<i>b</i>', $op->getPageTitle() );
585 $this->assertSame(
586 $this->getMsgText( $op, 'pagetitle', '<script>a</script>&b' ),
587 $op->getHTMLTitle()
588 );
589
590 // Test set to message
591 $text = $this->getMsgText( $op, 'mainpage' );
592
593 $op->setPageTitle( $op->msg( 'mainpage' )->inContentLanguage() );
594 $this->assertSame( $text, $op->getPageTitle() );
595 $this->assertSame( $this->getMsgText( $op, 'pagetitle', $text ), $op->getHTMLTitle() );
596 }
597
598 /**
599 * @covers OutputPage::setTitle
600 */
601 public function testSetTitle() {
602 $op = $this->newInstance();
603
604 $this->assertSame( 'My test page', $op->getTitle()->getPrefixedText() );
605
606 $op->setTitle( Title::newFromText( 'Another test page' ) );
607
608 $this->assertSame( 'Another test page', $op->getTitle()->getPrefixedText() );
609 }
610
611 /**
612 * @covers OutputPage::setSubtitle
613 * @covers OutputPage::clearSubtitle
614 * @covers OutputPage::addSubtitle
615 * @covers OutputPage::getSubtitle
616 */
617 public function testSubtitle() {
618 $op = $this->newInstance();
619
620 $this->assertSame( '', $op->getSubtitle() );
621
622 $op->addSubtitle( '<b>foo</b>' );
623
624 $this->assertSame( '<b>foo</b>', $op->getSubtitle() );
625
626 $op->addSubtitle( $op->msg( 'mainpage' )->inContentLanguage() );
627
628 $this->assertSame(
629 "<b>foo</b><br />\n\t\t\t\t" . $this->getMsgText( $op, 'mainpage' ),
630 $op->getSubtitle()
631 );
632
633 $op->setSubtitle( 'There can be only one' );
634
635 $this->assertSame( 'There can be only one', $op->getSubtitle() );
636
637 $op->clearSubtitle();
638
639 $this->assertSame( '', $op->getSubtitle() );
640 }
641
642 /**
643 * @dataProvider provideBacklinkSubtitle
644 *
645 * @covers OutputPage::buildBacklinkSubtitle
646 */
647 public function testBuildBacklinkSubtitle( $titles, $queries, $contains, $notContains ) {
648 if ( count( $titles ) > 1 ) {
649 // Not applicable
650 $this->assertTrue( true );
651 return;
652 }
653
654 $title = Title::newFromText( $titles[0] );
655 $query = $queries[0];
656
657 $this->editPage( 'Page 1', '' );
658 $this->editPage( 'Page 2', '#REDIRECT [[Page 1]]' );
659
660 $str = OutputPage::buildBacklinkSubtitle( $title, $query )->text();
661
662 foreach ( $contains as $substr ) {
663 $this->assertContains( $substr, $str );
664 }
665
666 foreach ( $notContains as $substr ) {
667 $this->assertNotContains( $substr, $str );
668 }
669 }
670
671 /**
672 * @dataProvider provideBacklinkSubtitle
673 *
674 * @covers OutputPage::addBacklinkSubtitle
675 * @covers OutputPage::getSubtitle
676 */
677 public function testAddBacklinkSubtitle( $titles, $queries, $contains, $notContains ) {
678 $this->editPage( 'Page 1', '' );
679 $this->editPage( 'Page 2', '#REDIRECT [[Page 1]]' );
680
681 $op = $this->newInstance();
682 foreach ( $titles as $i => $unused ) {
683 $op->addBacklinkSubtitle( Title::newFromText( $titles[$i] ), $queries[$i] );
684 }
685
686 $str = $op->getSubtitle();
687
688 foreach ( $contains as $substr ) {
689 $this->assertContains( $substr, $str );
690 }
691
692 foreach ( $notContains as $substr ) {
693 $this->assertNotContains( $substr, $str );
694 }
695 }
696
697 public function provideBacklinkSubtitle() {
698 return [
699 [
700 [ 'Page 1' ],
701 [ [] ],
702 [ 'Page 1' ],
703 [ 'redirect', 'Page 2' ],
704 ],
705 [
706 [ 'Page 2' ],
707 [ [] ],
708 [ 'redirect=no' ],
709 [ 'Page 1' ],
710 ],
711 [
712 [ 'Page 1' ],
713 [ [ 'action' => 'edit' ] ],
714 [ 'action=edit' ],
715 [],
716 ],
717 [
718 [ 'Page 1', 'Page 2' ],
719 [ [], [] ],
720 [ 'Page 1', 'Page 2', "<br />\n\t\t\t\t" ],
721 [],
722 ],
723 // @todo Anything else to test?
724 ];
725 }
726
727 /**
728 * @covers OutputPage::setPrintable
729 * @covers OutputPage::isPrintable
730 */
731 public function testPrintable() {
732 $op = $this->newInstance();
733
734 $this->assertFalse( $op->isPrintable() );
735
736 $op->setPrintable();
737
738 $this->assertTrue( $op->isPrintable() );
739 }
740
741 /**
742 * @covers OutputPage::disable
743 * @covers OutputPage::isDisabled
744 */
745 public function testDisable() {
746 $op = $this->newInstance();
747
748 $this->assertFalse( $op->isDisabled() );
749 $this->assertNotSame( '', $op->output( true ) );
750
751 $op->disable();
752
753 $this->assertTrue( $op->isDisabled() );
754 $this->assertSame( '', $op->output( true ) );
755 }
756
757 /**
758 * @covers OutputPage::showNewSectionLink
759 * @covers OutputPage::addParserOutputMetadata
760 * @covers OutputPage::addParserOutput
761 */
762 public function testShowNewSectionLink() {
763 $op = $this->newInstance();
764
765 $this->assertFalse( $op->showNewSectionLink() );
766
767 $pOut1 = $this->createParserOutputStub( 'getNewSection', true );
768 $op->addParserOutputMetadata( $pOut1 );
769 $this->assertTrue( $op->showNewSectionLink() );
770
771 $pOut2 = $this->createParserOutputStub( 'getNewSection', false );
772 $op->addParserOutput( $pOut2 );
773 $this->assertFalse( $op->showNewSectionLink() );
774 }
775
776 /**
777 * @covers OutputPage::forceHideNewSectionLink
778 * @covers OutputPage::addParserOutputMetadata
779 * @covers OutputPage::addParserOutput
780 */
781 public function testForceHideNewSectionLink() {
782 $op = $this->newInstance();
783
784 $this->assertFalse( $op->forceHideNewSectionLink() );
785
786 $pOut1 = $this->createParserOutputStub( 'getHideNewSection', true );
787 $op->addParserOutputMetadata( $pOut1 );
788 $this->assertTrue( $op->forceHideNewSectionLink() );
789
790 $pOut2 = $this->createParserOutputStub( 'getHideNewSection', false );
791 $op->addParserOutput( $pOut2 );
792 $this->assertFalse( $op->forceHideNewSectionLink() );
793 }
794
795 /**
796 * @covers OutputPage::setSyndicated
797 * @covers OutputPage::isSyndicated
798 */
799 public function testSetSyndicated() {
800 $op = $this->newInstance();
801 $this->assertFalse( $op->isSyndicated() );
802
803 $op->setSyndicated();
804 $this->assertTrue( $op->isSyndicated() );
805
806 $op->setSyndicated( false );
807 $this->assertFalse( $op->isSyndicated() );
808 }
809
810 /**
811 * @covers OutputPage::isSyndicated
812 * @covers OutputPage::setFeedAppendQuery
813 * @covers OutputPage::addFeedLink
814 * @covers OutputPage::getSyndicationLinks()
815 */
816 public function testFeedLinks() {
817 $op = $this->newInstance();
818 $this->assertSame( [], $op->getSyndicationLinks() );
819
820 $op->addFeedLink( 'not a supported format', 'abc' );
821 $this->assertFalse( $op->isSyndicated() );
822 $this->assertSame( [], $op->getSyndicationLinks() );
823
824 $feedTypes = $op->getConfig()->get( 'AdvertisedFeedTypes' );
825
826 $op->addFeedLink( $feedTypes[0], 'def' );
827 $this->assertTrue( $op->isSyndicated() );
828 $this->assertSame( [ $feedTypes[0] => 'def' ], $op->getSyndicationLinks() );
829
830 $op->setFeedAppendQuery( false );
831 $expected = [];
832 foreach ( $feedTypes as $type ) {
833 $expected[$type] = $op->getTitle()->getLocalURL( "feed=$type" );
834 }
835 $this->assertSame( $expected, $op->getSyndicationLinks() );
836
837 $op->setFeedAppendQuery( 'apples=oranges' );
838 foreach ( $feedTypes as $type ) {
839 $expected[$type] = $op->getTitle()->getLocalURL( "feed=$type&apples=oranges" );
840 }
841 $this->assertSame( $expected, $op->getSyndicationLinks() );
842 }
843
844 /**
845 * @covers OutputPage::setArticleFlag
846 * @covers OutputPage::isArticle
847 * @covers OutputPage::setArticleRelated
848 * @covers OutputPage::isArticleRelated
849 */
850 function testArticleFlags() {
851 $op = $this->newInstance();
852 $this->assertFalse( $op->isArticle() );
853 $this->assertTrue( $op->isArticleRelated() );
854
855 $op->setArticleRelated( false );
856 $this->assertFalse( $op->isArticle() );
857 $this->assertFalse( $op->isArticleRelated() );
858
859 $op->setArticleFlag( true );
860 $this->assertTrue( $op->isArticle() );
861 $this->assertTrue( $op->isArticleRelated() );
862
863 $op->setArticleFlag( false );
864 $this->assertFalse( $op->isArticle() );
865 $this->assertTrue( $op->isArticleRelated() );
866
867 $op->setArticleFlag( true );
868 $op->setArticleRelated( false );
869 $this->assertFalse( $op->isArticle() );
870 $this->assertFalse( $op->isArticleRelated() );
871 }
872
873 /**
874 * @covers OutputPage::addLanguageLinks
875 * @covers OutputPage::setLanguageLinks
876 * @covers OutputPage::getLanguageLinks
877 * @covers OutputPage::addParserOutputMetadata
878 * @covers OutputPage::addParserOutput
879 */
880 function testLanguageLinks() {
881 $op = $this->newInstance();
882 $this->assertSame( [], $op->getLanguageLinks() );
883
884 $op->addLanguageLinks( [ 'fr:A', 'it:B' ] );
885 $this->assertSame( [ 'fr:A', 'it:B' ], $op->getLanguageLinks() );
886
887 $op->addLanguageLinks( [ 'de:C', 'es:D' ] );
888 $this->assertSame( [ 'fr:A', 'it:B', 'de:C', 'es:D' ], $op->getLanguageLinks() );
889
890 $op->setLanguageLinks( [ 'pt:E' ] );
891 $this->assertSame( [ 'pt:E' ], $op->getLanguageLinks() );
892
893 $pOut1 = $this->createParserOutputStub( 'getLanguageLinks', [ 'he:F', 'ar:G' ] );
894 $op->addParserOutputMetadata( $pOut1 );
895 $this->assertSame( [ 'pt:E', 'he:F', 'ar:G' ], $op->getLanguageLinks() );
896
897 $pOut2 = $this->createParserOutputStub( 'getLanguageLinks', [ 'pt:H' ] );
898 $op->addParserOutput( $pOut2 );
899 $this->assertSame( [ 'pt:E', 'he:F', 'ar:G', 'pt:H' ], $op->getLanguageLinks() );
900 }
901
902 // @todo Are these category links tests too abstract and complicated for what they test? Would
903 // it make sense to just write out all the tests by hand with maybe some copy-and-paste?
904
905 /**
906 * @dataProvider provideGetCategories
907 *
908 * @covers OutputPage::addCategoryLinks
909 * @covers OutputPage::getCategories
910 * @covers OutputPage::getCategoryLinks
911 *
912 * @param array $args Array of form [ category name => sort key ]
913 * @param array $fakeResults Array of form [ category name => value to return from mocked
914 * LinkBatch ]
915 * @param callback $variantLinkCallback Callback to replace findVariantLink() call
916 * @param array $expectedNormal Expected return value of getCategoryLinks['normal']
917 * @param array $expectedHidden Expected return value of getCategoryLinks['hidden']
918 */
919 public function testAddCategoryLinks(
920 array $args, array $fakeResults, callable $variantLinkCallback = null,
921 array $expectedNormal, array $expectedHidden
922 ) {
923 $expectedNormal = $this->extractExpectedCategories( $expectedNormal, 'add' );
924 $expectedHidden = $this->extractExpectedCategories( $expectedHidden, 'add' );
925
926 $op = $this->setupCategoryTests( $fakeResults, $variantLinkCallback );
927
928 $op->addCategoryLinks( $args );
929
930 $this->doCategoryAsserts( $op, $expectedNormal, $expectedHidden );
931 $this->doCategoryLinkAsserts( $op, $expectedNormal, $expectedHidden );
932 }
933
934 /**
935 * @dataProvider provideGetCategories
936 *
937 * @covers OutputPage::addCategoryLinks
938 * @covers OutputPage::getCategories
939 * @covers OutputPage::getCategoryLinks
940 */
941 public function testAddCategoryLinksOneByOne(
942 array $args, array $fakeResults, callable $variantLinkCallback = null,
943 array $expectedNormal, array $expectedHidden
944 ) {
945 if ( count( $args ) <= 1 ) {
946 // @todo Should this be skipped instead of passed?
947 $this->assertTrue( true );
948 return;
949 }
950
951 $expectedNormal = $this->extractExpectedCategories( $expectedNormal, 'onebyone' );
952 $expectedHidden = $this->extractExpectedCategories( $expectedHidden, 'onebyone' );
953
954 $op = $this->setupCategoryTests( $fakeResults, $variantLinkCallback );
955
956 foreach ( $args as $key => $val ) {
957 $op->addCategoryLinks( [ $key => $val ] );
958 }
959
960 $this->doCategoryAsserts( $op, $expectedNormal, $expectedHidden );
961 $this->doCategoryLinkAsserts( $op, $expectedNormal, $expectedHidden );
962 }
963
964 /**
965 * @dataProvider provideGetCategories
966 *
967 * @covers OutputPage::setCategoryLinks
968 * @covers OutputPage::getCategories
969 * @covers OutputPage::getCategoryLinks
970 */
971 public function testSetCategoryLinks(
972 array $args, array $fakeResults, callable $variantLinkCallback = null,
973 array $expectedNormal, array $expectedHidden
974 ) {
975 $expectedNormal = $this->extractExpectedCategories( $expectedNormal, 'set' );
976 $expectedHidden = $this->extractExpectedCategories( $expectedHidden, 'set' );
977
978 $op = $this->setupCategoryTests( $fakeResults, $variantLinkCallback );
979
980 $op->setCategoryLinks( [ 'Initial page' => 'Initial page' ] );
981 $op->setCategoryLinks( $args );
982
983 // We don't reset the categories, for some reason, only the links
984 $expectedNormalCats = array_merge( [ 'Initial page' ], $expectedNormal );
985 $expectedCats = array_merge( $expectedHidden, $expectedNormalCats );
986
987 $this->doCategoryAsserts( $op, $expectedNormalCats, $expectedHidden );
988 $this->doCategoryLinkAsserts( $op, $expectedNormal, $expectedHidden );
989 }
990
991 /**
992 * @dataProvider provideGetCategories
993 *
994 * @covers OutputPage::addParserOutputMetadata
995 * @covers OutputPage::addParserOutput
996 * @covers OutputPage::getCategories
997 * @covers OutputPage::getCategoryLinks
998 */
999 public function testParserOutputCategoryLinks(
1000 array $args, array $fakeResults, callable $variantLinkCallback = null,
1001 array $expectedNormal, array $expectedHidden
1002 ) {
1003 $expectedNormal = $this->extractExpectedCategories( $expectedNormal, 'pout' );
1004 $expectedHidden = $this->extractExpectedCategories( $expectedHidden, 'pout' );
1005
1006 $op = $this->setupCategoryTests( $fakeResults, $variantLinkCallback );
1007
1008 $stubPO = $this->createParserOutputStub( 'getCategories', $args );
1009
1010 // addParserOutput and addParserOutputMetadata should behave identically for us, so
1011 // alternate to get coverage for both without adding extra tests
1012 static $idx = 0;
1013 $idx++;
1014 $method = [ 'addParserOutputMetadata', 'addParserOutput' ][$idx % 2];
1015 $op->$method( $stubPO );
1016
1017 $this->doCategoryAsserts( $op, $expectedNormal, $expectedHidden );
1018 $this->doCategoryLinkAsserts( $op, $expectedNormal, $expectedHidden );
1019 }
1020
1021 /**
1022 * We allow different expectations for different tests as an associative array, like
1023 * [ 'set' => [ ... ], 'default' => [ ... ] ] if setCategoryLinks() will give a different
1024 * result.
1025 */
1026 private function extractExpectedCategories( array $expected, $key ) {
1027 if ( !$expected || isset( $expected[0] ) ) {
1028 return $expected;
1029 }
1030 return $expected[$key] ?? $expected['default'];
1031 }
1032
1033 private function setupCategoryTests(
1034 array $fakeResults, callable $variantLinkCallback = null
1035 ) : OutputPage {
1036 $this->setMwGlobals( 'wgUsePigLatinVariant', true );
1037
1038 $op = $this->getMockBuilder( OutputPage::class )
1039 ->setConstructorArgs( [ new RequestContext() ] )
1040 ->setMethods( [ 'addCategoryLinksToLBAndGetResult', 'getTitle' ] )
1041 ->getMock();
1042
1043 $title = Title::newFromText( 'My test page' );
1044 $op->expects( $this->any() )
1045 ->method( 'getTitle' )
1046 ->will( $this->returnValue( $title ) );
1047
1048 $op->expects( $this->any() )
1049 ->method( 'addCategoryLinksToLBAndGetResult' )
1050 ->will( $this->returnCallback( function ( array $categories ) use ( $fakeResults ) {
1051 $return = [];
1052 foreach ( $categories as $category => $unused ) {
1053 if ( isset( $fakeResults[$category] ) ) {
1054 $return[] = $fakeResults[$category];
1055 }
1056 }
1057 return new FakeResultWrapper( $return );
1058 } ) );
1059
1060 if ( $variantLinkCallback ) {
1061 $mockContLang = $this->getMockBuilder( Language::class )
1062 ->setConstructorArgs( [ 'en' ] )
1063 ->setMethods( [ 'findVariantLink' ] )
1064 ->getMock();
1065 $mockContLang->expects( $this->any() )
1066 ->method( 'findVariantLink' )
1067 ->will( $this->returnCallback( $variantLinkCallback ) );
1068 $this->setContentLang( $mockContLang );
1069 }
1070
1071 $this->assertSame( [], $op->getCategories() );
1072
1073 return $op;
1074 }
1075
1076 private function doCategoryAsserts( $op, $expectedNormal, $expectedHidden ) {
1077 $this->assertSame( array_merge( $expectedHidden, $expectedNormal ), $op->getCategories() );
1078 $this->assertSame( $expectedNormal, $op->getCategories( 'normal' ) );
1079 $this->assertSame( $expectedHidden, $op->getCategories( 'hidden' ) );
1080 }
1081
1082 private function doCategoryLinkAsserts( $op, $expectedNormal, $expectedHidden ) {
1083 $catLinks = $op->getCategoryLinks();
1084 $this->assertSame( (bool)$expectedNormal + (bool)$expectedHidden, count( $catLinks ) );
1085 if ( $expectedNormal ) {
1086 $this->assertSame( count( $expectedNormal ), count( $catLinks['normal'] ) );
1087 }
1088 if ( $expectedHidden ) {
1089 $this->assertSame( count( $expectedHidden ), count( $catLinks['hidden'] ) );
1090 }
1091
1092 foreach ( $expectedNormal as $i => $name ) {
1093 $this->assertContains( $name, $catLinks['normal'][$i] );
1094 }
1095 foreach ( $expectedHidden as $i => $name ) {
1096 $this->assertContains( $name, $catLinks['hidden'][$i] );
1097 }
1098 }
1099
1100 public function provideGetCategories() {
1101 return [
1102 'No categories' => [ [], [], null, [], [] ],
1103 'Simple test' => [
1104 [ 'Test1' => 'Some sortkey', 'Test2' => 'A different sortkey' ],
1105 [ 'Test1' => (object)[ 'pp_value' => 1, 'page_title' => 'Test1' ],
1106 'Test2' => (object)[ 'page_title' => 'Test2' ] ],
1107 null,
1108 [ 'Test2' ],
1109 [ 'Test1' ],
1110 ],
1111 'Invalid title' => [
1112 [ '[' => '[', 'Test' => 'Test' ],
1113 [ 'Test' => (object)[ 'page_title' => 'Test' ] ],
1114 null,
1115 [ 'Test' ],
1116 [],
1117 ],
1118 'Variant link' => [
1119 [ 'Test' => 'Test', 'Estay' => 'Estay' ],
1120 [ 'Test' => (object)[ 'page_title' => 'Test' ] ],
1121 function ( &$link, &$title ) {
1122 if ( $link === 'Estay' ) {
1123 $link = 'Test';
1124 $title = Title::makeTitleSafe( NS_CATEGORY, $link );
1125 }
1126 },
1127 // For adding one by one, the variant gets added as well as the original category,
1128 // but if you add them all together the second time gets skipped.
1129 [ 'onebyone' => [ 'Test', 'Test' ], 'default' => [ 'Test' ] ],
1130 [],
1131 ],
1132 ];
1133 }
1134
1135 /**
1136 * @covers OutputPage::getCategories
1137 */
1138 public function testGetCategoriesInvalid() {
1139 $this->setExpectedException( InvalidArgumentException::class,
1140 'Invalid category type given: hiddne' );
1141
1142 $op = $this->newInstance();
1143 $op->getCategories( 'hiddne' );
1144 }
1145
1146 // @todo Should we test addCategoryLinksToLBAndGetResult? If so, how? Insert some test rows in
1147 // the DB?
1148
1149 /**
1150 * @covers OutputPage::setIndicators
1151 * @covers OutputPage::getIndicators
1152 * @covers OutputPage::addParserOutputMetadata
1153 * @covers OutputPage::addParserOutput
1154 */
1155 public function testIndicators() {
1156 $op = $this->newInstance();
1157 $this->assertSame( [], $op->getIndicators() );
1158
1159 $op->setIndicators( [] );
1160 $this->assertSame( [], $op->getIndicators() );
1161
1162 // Test sorting alphabetically
1163 $op->setIndicators( [ 'b' => 'x', 'a' => 'y' ] );
1164 $this->assertSame( [ 'a' => 'y', 'b' => 'x' ], $op->getIndicators() );
1165
1166 // Test overwriting existing keys
1167 $op->setIndicators( [ 'c' => 'z', 'a' => 'w' ] );
1168 $this->assertSame( [ 'a' => 'w', 'b' => 'x', 'c' => 'z' ], $op->getIndicators() );
1169
1170 // Test with addParserOutputMetadata
1171 $pOut1 = $this->createParserOutputStub( 'getIndicators', [ 'c' => 'u', 'd' => 'v' ] );
1172 $op->addParserOutputMetadata( $pOut1 );
1173 $this->assertSame( [ 'a' => 'w', 'b' => 'x', 'c' => 'u', 'd' => 'v' ],
1174 $op->getIndicators() );
1175
1176 // Test with addParserOutput
1177 $pOut2 = $this->createParserOutputStub( 'getIndicators', [ 'a' => '!!!' ] );
1178 $op->addParserOutput( $pOut2 );
1179 $this->assertSame( [ 'a' => '!!!', 'b' => 'x', 'c' => 'u', 'd' => 'v' ],
1180 $op->getIndicators() );
1181 }
1182
1183 /**
1184 * @covers OutputPage::addHelpLink
1185 * @covers OutputPage::getIndicators
1186 */
1187 public function testAddHelpLink() {
1188 $op = $this->newInstance();
1189
1190 $op->addHelpLink( 'Manual:PHP unit testing' );
1191 $indicators = $op->getIndicators();
1192 $this->assertSame( [ 'mw-helplink' ], array_keys( $indicators ) );
1193 $this->assertContains( 'Manual:PHP_unit_testing', $indicators['mw-helplink'] );
1194
1195 $op->addHelpLink( 'https://phpunit.de', true );
1196 $indicators = $op->getIndicators();
1197 $this->assertSame( [ 'mw-helplink' ], array_keys( $indicators ) );
1198 $this->assertContains( 'https://phpunit.de', $indicators['mw-helplink'] );
1199 $this->assertNotContains( 'mediawiki', $indicators['mw-helplink'] );
1200 $this->assertNotContains( 'Manual:PHP', $indicators['mw-helplink'] );
1201 }
1202
1203 /**
1204 * @covers OutputPage::prependHTML
1205 * @covers OutputPage::addHTML
1206 * @covers OutputPage::addElement
1207 * @covers OutputPage::clearHTML
1208 * @covers OutputPage::getHTML
1209 */
1210 public function testBodyHTML() {
1211 $op = $this->newInstance();
1212 $this->assertSame( '', $op->getHTML() );
1213
1214 $op->addHTML( 'a' );
1215 $this->assertSame( 'a', $op->getHTML() );
1216
1217 $op->addHTML( 'b' );
1218 $this->assertSame( 'ab', $op->getHTML() );
1219
1220 $op->prependHTML( 'c' );
1221 $this->assertSame( 'cab', $op->getHTML() );
1222
1223 $op->addElement( 'p', [ 'id' => 'foo' ], 'd' );
1224 $this->assertSame( 'cab<p id="foo">d</p>', $op->getHTML() );
1225
1226 $op->clearHTML();
1227 $this->assertSame( '', $op->getHTML() );
1228 }
1229
1230 /**
1231 * @dataProvider provideRevisionId
1232 * @covers OutputPage::setRevisionId
1233 * @covers OutputPage::getRevisionId
1234 */
1235 public function testRevisionId( $newVal, $expected ) {
1236 $op = $this->newInstance();
1237
1238 $this->assertNull( $op->setRevisionId( $newVal ) );
1239 $this->assertSame( $expected, $op->getRevisionId() );
1240 $this->assertSame( $expected, $op->setRevisionId( null ) );
1241 $this->assertNull( $op->getRevisionId() );
1242 }
1243
1244 public function provideRevisionId() {
1245 return [
1246 [ null, null ],
1247 [ 7, 7 ],
1248 [ -1, -1 ],
1249 [ 3.2, 3 ],
1250 [ '0', 0 ],
1251 [ '32% finished', 32 ],
1252 [ false, 0 ],
1253 ];
1254 }
1255
1256 /**
1257 * @covers OutputPage::setRevisionTimestamp
1258 * @covers OutputPage::getRevisionTimestamp
1259 */
1260 public function testRevisionTimestamp() {
1261 $op = $this->newInstance();
1262 $this->assertNull( $op->getRevisionTimestamp() );
1263
1264 $this->assertNull( $op->setRevisionTimestamp( 'abc' ) );
1265 $this->assertSame( 'abc', $op->getRevisionTimestamp() );
1266 $this->assertSame( 'abc', $op->setRevisionTimestamp( null ) );
1267 $this->assertNull( $op->getRevisionTimestamp() );
1268 }
1269
1270 /**
1271 * @covers OutputPage::setFileVersion
1272 * @covers OutputPage::getFileVersion
1273 */
1274 public function testFileVersion() {
1275 $op = $this->newInstance();
1276 $this->assertNull( $op->getFileVersion() );
1277
1278 $stubFile = $this->createMock( File::class );
1279 $stubFile->method( 'exists' )->willReturn( true );
1280 $stubFile->method( 'getTimestamp' )->willReturn( '12211221123321' );
1281 $stubFile->method( 'getSha1' )->willReturn( 'bf3ffa7047dc080f5855377a4f83cd18887e3b05' );
1282
1283 $op->setFileVersion( $stubFile );
1284
1285 $this->assertEquals(
1286 [ 'time' => '12211221123321', 'sha1' => 'bf3ffa7047dc080f5855377a4f83cd18887e3b05' ],
1287 $op->getFileVersion()
1288 );
1289
1290 $stubMissingFile = $this->createMock( File::class );
1291 $stubMissingFile->method( 'exists' )->willReturn( false );
1292
1293 $op->setFileVersion( $stubMissingFile );
1294 $this->assertNull( $op->getFileVersion() );
1295
1296 $op->setFileVersion( $stubFile );
1297 $this->assertNotNull( $op->getFileVersion() );
1298
1299 $op->setFileVersion( null );
1300 $this->assertNull( $op->getFileVersion() );
1301 }
1302
1303 /**
1304 * Call either with arguments $methodName, $returnValue; or an array
1305 * [ $methodName => $returnValue, $methodName => $returnValue, ... ]
1306 */
1307 private function createParserOutputStub( ...$args ) {
1308 if ( count( $args ) === 0 ) {
1309 $retVals = [];
1310 } elseif ( count( $args ) === 1 ) {
1311 $retVals = $args[0];
1312 } elseif ( count( $args ) === 2 ) {
1313 $retVals = [ $args[0] => $args[1] ];
1314 }
1315 $pOut = $this->getMock( ParserOutput::class );
1316 foreach ( $retVals as $method => $retVal ) {
1317 $pOut->method( $method )->willReturn( $retVal );
1318 }
1319
1320 $arrayReturningMethods = [
1321 'getCategories',
1322 'getFileSearchOptions',
1323 'getHeadItems',
1324 'getIndicators',
1325 'getLanguageLinks',
1326 'getOutputHooks',
1327 'getTemplateIds',
1328 ];
1329
1330 foreach ( $arrayReturningMethods as $method ) {
1331 $pOut->method( $method )->willReturn( [] );
1332 }
1333
1334 return $pOut;
1335 }
1336
1337 /**
1338 * @covers OutputPage::getTemplateIds
1339 * @covers OutputPage::addParserOutputMetadata
1340 * @covers OutputPage::addParserOutput
1341 */
1342 public function testTemplateIds() {
1343 $op = $this->newInstance();
1344 $this->assertSame( [], $op->getTemplateIds() );
1345
1346 // Test with no template id's
1347 $stubPOEmpty = $this->createParserOutputStub();
1348 $op->addParserOutputMetadata( $stubPOEmpty );
1349 $this->assertSame( [], $op->getTemplateIds() );
1350
1351 // Test with some arbitrary template id's
1352 $ids = [
1353 NS_MAIN => [ 'A' => 3, 'B' => 17 ],
1354 NS_TALK => [ 'C' => 31 ],
1355 NS_MEDIA => [ 'D' => -1 ],
1356 ];
1357
1358 $stubPO1 = $this->createParserOutputStub( 'getTemplateIds', $ids );
1359
1360 $op->addParserOutputMetadata( $stubPO1 );
1361 $this->assertSame( $ids, $op->getTemplateIds() );
1362
1363 // Test merging with a second set of id's
1364 $stubPO2 = $this->createParserOutputStub( 'getTemplateIds', [
1365 NS_MAIN => [ 'E' => 1234 ],
1366 NS_PROJECT => [ 'F' => 5678 ],
1367 ] );
1368
1369 $finalIds = [
1370 NS_MAIN => [ 'E' => 1234, 'A' => 3, 'B' => 17 ],
1371 NS_TALK => [ 'C' => 31 ],
1372 NS_MEDIA => [ 'D' => -1 ],
1373 NS_PROJECT => [ 'F' => 5678 ],
1374 ];
1375
1376 $op->addParserOutput( $stubPO2 );
1377 $this->assertSame( $finalIds, $op->getTemplateIds() );
1378
1379 // Test merging with an empty set of id's
1380 $op->addParserOutputMetadata( $stubPOEmpty );
1381 $this->assertSame( $finalIds, $op->getTemplateIds() );
1382 }
1383
1384 /**
1385 * @covers OutputPage::getFileSearchOptions
1386 * @covers OutputPage::addParserOutputMetadata
1387 * @covers OutputPage::addParserOutput
1388 */
1389 public function testFileSearchOptions() {
1390 $op = $this->newInstance();
1391 $this->assertSame( [], $op->getFileSearchOptions() );
1392
1393 // Test with no files
1394 $stubPOEmpty = $this->createParserOutputStub();
1395
1396 $op->addParserOutputMetadata( $stubPOEmpty );
1397 $this->assertSame( [], $op->getFileSearchOptions() );
1398
1399 // Test with some arbitrary files
1400 $files1 = [
1401 'A' => [ 'time' => null, 'sha1' => '' ],
1402 'B' => [
1403 'time' => '12211221123321',
1404 'sha1' => 'bf3ffa7047dc080f5855377a4f83cd18887e3b05',
1405 ],
1406 ];
1407
1408 $stubPO1 = $this->createParserOutputStub( 'getFileSearchOptions', $files1 );
1409
1410 $op->addParserOutput( $stubPO1 );
1411 $this->assertSame( $files1, $op->getFileSearchOptions() );
1412
1413 // Test merging with a second set of files
1414 $files2 = [
1415 'C' => [ 'time' => null, 'sha1' => '' ],
1416 'B' => [ 'time' => null, 'sha1' => '' ],
1417 ];
1418
1419 $stubPO2 = $this->createParserOutputStub( 'getFileSearchOptions', $files2 );
1420
1421 $op->addParserOutputMetadata( $stubPO2 );
1422 $this->assertSame( array_merge( $files1, $files2 ), $op->getFileSearchOptions() );
1423
1424 // Test merging with an empty set of files
1425 $op->addParserOutput( $stubPOEmpty );
1426 $this->assertSame( array_merge( $files1, $files2 ), $op->getFileSearchOptions() );
1427 }
1428
1429 /**
1430 * @dataProvider provideAddWikiText
1431 * @covers OutputPage::addWikiText
1432 * @covers OutputPage::addWikiTextAsInterface
1433 * @covers OutputPage::wrapWikiTextAsInterface
1434 * @covers OutputPage::addWikiTextAsContent
1435 * @covers OutputPage::addWikiTextWithTitle
1436 * @covers OutputPage::addWikiTextTitle
1437 * @covers OutputPage::addWikiTextTidy
1438 * @covers OutputPage::addWikiTextTitleTidy
1439 * @covers OutputPage::getHTML
1440 */
1441 public function testAddWikiText( $method, array $args, $expected ) {
1442 $op = $this->newInstance();
1443 $this->assertSame( '', $op->getHTML() );
1444
1445 $this->hideDeprecated( 'OutputPage::addWikiTextTitle' );
1446 $this->hideDeprecated( 'OutputPage::addWikiTextWithTitle' );
1447 $this->hideDeprecated( 'OutputPage::addWikiTextTidy' );
1448 $this->hideDeprecated( 'OutputPage::addWikiTextTitleTidy' );
1449 if ( in_array(
1450 $method,
1451 [ 'addWikiTextWithTitle', 'addWikiTextTitleTidy', 'addWikiTextTitle' ]
1452 ) && count( $args ) >= 2 && $args[1] === null ) {
1453 // Special placeholder because we can't get the actual title in the provider
1454 $args[1] = $op->getTitle();
1455 }
1456 if ( in_array(
1457 $method,
1458 [ 'addWikiTextAsInterface', 'addWikiTextAsContent' ]
1459 ) && count( $args ) >= 3 && $args[2] === null ) {
1460 // Special placeholder because we can't get the actual title in the provider
1461 $args[2] = $op->getTitle();
1462 }
1463
1464 $op->$method( ...$args );
1465 $this->assertSame( $expected, $op->getHTML() );
1466 }
1467
1468 public function provideAddWikiText() {
1469 $tests = [
1470 'addWikiText' => [
1471 // Not tidied; this API is deprecated.
1472 'Simple wikitext' => [
1473 [ "'''Bold'''" ],
1474 "<p><b>Bold</b>\n</p>",
1475 ], 'List at start' => [
1476 [ '* List' ],
1477 "<ul><li>List</li></ul>\n",
1478 ], 'List not at start' => [
1479 [ '* Not a list', false ],
1480 '* Not a list',
1481 ], 'Non-interface' => [
1482 [ "'''Bold'''", true, false ],
1483 "<p><b>Bold</b>\n</p>",
1484 ], 'No section edit links' => [
1485 [ '== Title ==' ],
1486 "<h2><span class=\"mw-headline\" id=\"Title\">Title</span></h2>\n",
1487 ],
1488 ],
1489 'addWikiTextWithTitle' => [
1490 // Untidied; this API is deprecated
1491 'With title at start' => [
1492 [ '* {{PAGENAME}}', Title::newFromText( 'Talk:Some page' ) ],
1493 "<ul><li>Some page</li></ul>\n",
1494 ], 'With title at start' => [
1495 [ '* {{PAGENAME}}', Title::newFromText( 'Talk:Some page' ), false ],
1496 "* Some page",
1497 ],
1498 ],
1499 'addWikiTextAsInterface' => [
1500 // Preferred interface: output is tidied
1501 'Simple wikitext' => [
1502 [ "'''Bold'''" ],
1503 "<p><b>Bold</b>\n</p>",
1504 ], 'Untidy wikitext' => [
1505 [ "<b>Bold" ],
1506 "<p><b>Bold\n</b></p>",
1507 ], 'List at start' => [
1508 [ '* List' ],
1509 "<ul><li>List</li></ul>\n",
1510 ], 'List not at start' => [
1511 [ '* Not a list', false ],
1512 '<p>* Not a list</p>',
1513 ], 'No section edit links' => [
1514 [ '== Title ==' ],
1515 "<h2><span class=\"mw-headline\" id=\"Title\">Title</span></h2>\n",
1516 ], 'With title at start' => [
1517 [ '* {{PAGENAME}}', true, Title::newFromText( 'Talk:Some page' ) ],
1518 "<ul><li>Some page</li></ul>\n",
1519 ], 'With title at start' => [
1520 [ '* {{PAGENAME}}', false, Title::newFromText( 'Talk:Some page' ), false ],
1521 "<p>* Some page</p>",
1522 ], 'Untidy input' => [
1523 [ '<b>{{PAGENAME}}', true, Title::newFromText( 'Talk:Some page' ) ],
1524 "<p><b>Some page\n</b></p>",
1525 ],
1526 ],
1527 'addWikiTextAsContent' => [
1528 // Preferred interface: output is tidied
1529 'SpecialNewimages' => [
1530 [ "<p lang='en' dir='ltr'>\nMy message" ],
1531 '<p lang="en" dir="ltr">' . "\nMy message\n</p>"
1532 ], 'List at start' => [
1533 [ '* List' ],
1534 "<ul><li>List</li></ul>\n",
1535 ], 'List not at start' => [
1536 [ '* <b>Not a list', false ],
1537 '<p>* <b>Not a list</b></p>',
1538 ], 'With title at start' => [
1539 [ '* {{PAGENAME}}', true, Title::newFromText( 'Talk:Some page' ) ],
1540 "<ul><li>Some page</li></ul>\n",
1541 ], 'With title at start' => [
1542 [ '* {{PAGENAME}}', false, Title::newFromText( 'Talk:Some page' ), false ],
1543 "<p>* Some page</p>",
1544 ], 'EditPage' => [
1545 [ "<div class='mw-editintro'>{{PAGENAME}}", true, Title::newFromText( 'Talk:Some page' ) ],
1546 '<div class="mw-editintro">' . "Some page\n</div>"
1547 ],
1548 ],
1549 'wrapWikiTextAsInterface' => [
1550 'Simple' => [
1551 [ 'wrapperClass', 'text' ],
1552 "<div class=\"wrapperClass\"><p>text\n</p></div>"
1553 ], 'Spurious </div>' => [
1554 [ 'wrapperClass', 'text</div><div>more' ],
1555 "<div class=\"wrapperClass\"><p>text</p><div>more\n</div></div>"
1556 ], 'Extra newlines would break <p> wrappers' => [
1557 [ 'two classes', "1\n\n2\n\n3" ],
1558 "<div class=\"two classes\"><p>1\n</p><p>2\n</p><p>3\n</p></div>"
1559 ], 'Other unclosed tags' => [
1560 [ 'error', 'a<b>c<i>d' ],
1561 "<div class=\"error\"><p>a<b>c<i>d\n</i></b></p></div>"
1562 ],
1563 ],
1564 ];
1565
1566 // Test all the others on addWikiTextTitle as well
1567 foreach ( $tests['addWikiText'] as $key => $val ) {
1568 $args = [ $val[0][0], null, $val[0][1] ?? true, false, $val[0][2] ?? true ];
1569 $tests['addWikiTextTitle']["$key (addWikiTextTitle)"] =
1570 array_merge( [ $args ], array_slice( $val, 1 ) );
1571 }
1572 foreach ( $tests['addWikiTextWithTitle'] as $key => $val ) {
1573 $args = [ $val[0][0], $val[0][1], $val[0][2] ?? true ];
1574 $tests['addWikiTextTitle']["$key (addWikiTextTitle)"] =
1575 array_merge( [ $args ], array_slice( $val, 1 ) );
1576 }
1577 foreach ( $tests['addWikiTextAsInterface'] as $key => $val ) {
1578 $args = [ $val[0][0], $val[0][2] ?? null, $val[0][1] ?? true, true, true ];
1579 $tests['addWikiTextTitle']["$key (addWikiTextTitle)"] =
1580 array_merge( [ $args ], array_slice( $val, 1 ) );
1581 }
1582 foreach ( $tests['addWikiTextAsContent'] as $key => $val ) {
1583 $args = [ $val[0][0], $val[0][2] ?? null, $val[0][1] ?? true, true, false ];
1584 $tests['addWikiTextTitle']["$key (addWikiTextTitle)"] =
1585 array_merge( [ $args ], array_slice( $val, 1 ) );
1586 }
1587 // addWikiTextTidy / addWikiTextTitleTidy were old aliases of
1588 // addWikiTextAsContent
1589 foreach ( $tests['addWikiTextAsContent'] as $key => $val ) {
1590 if ( count( $val[0] ) > 2 ) {
1591 $args = [ $val[0][0], $val[0][2], $val[0][1] ?? true ];
1592 $tests['addWikiTextTitleTidy']["$key (addWikiTextTitleTidy)"] =
1593 array_merge( [ $args ], array_slice( $val, 1 ) );
1594 } else {
1595 $args = [ $val[0][0], $val[0][1] ?? true ];
1596 $tests['addWikiTextTidy']["$key (addWikiTextTidy)"] =
1597 array_merge( [ $args ], array_slice( $val, 1 ) );
1598 }
1599 }
1600
1601 // We have to reformat our array to match what PHPUnit wants
1602 $ret = [];
1603 foreach ( $tests as $key => $subarray ) {
1604 foreach ( $subarray as $subkey => $val ) {
1605 $val = array_merge( [ $key ], $val );
1606 $ret[$subkey] = $val;
1607 }
1608 }
1609
1610 return $ret;
1611 }
1612
1613 /**
1614 * @covers OutputPage::addWikiText
1615 */
1616 public function testAddWikiTextNoTitle() {
1617 $this->setExpectedException( MWException::class, 'Title is null' );
1618
1619 $op = $this->newInstance( [], null, 'notitle' );
1620 $op->addWikiText( 'a' );
1621 }
1622
1623 /**
1624 * @covers OutputPage::addWikiTextAsInterface
1625 */
1626 public function testAddWikiTextAsInterfaceNoTitle() {
1627 $this->setExpectedException( MWException::class, 'Title is null' );
1628
1629 $op = $this->newInstance( [], null, 'notitle' );
1630 $op->addWikiTextAsInterface( 'a' );
1631 }
1632
1633 /**
1634 * @covers OutputPage::addWikiTextAsContent
1635 */
1636 public function testAddWikiTextAsContentNoTitle() {
1637 $this->setExpectedException( MWException::class, 'Title is null' );
1638
1639 $op = $this->newInstance( [], null, 'notitle' );
1640 $op->addWikiTextAsContent( 'a' );
1641 }
1642
1643 /**
1644 * @covers OutputPage::addWikiMsg
1645 */
1646 public function testAddWikiMsg() {
1647 $msg = wfMessage( 'parentheses' );
1648 $this->assertSame( '(a)', $msg->rawParams( 'a' )->plain() );
1649
1650 $op = $this->newInstance();
1651 $this->assertSame( '', $op->getHTML() );
1652 $op->addWikiMsg( 'parentheses', "<b>a" );
1653 // This is known to be bad unbalanced HTML; this will be fixed
1654 // by I743f4185a03403f8d9b9db010ff1ee4e9342e062 (T198214)
1655 $this->assertSame( "<p>(<b>a)\n</p>", $op->getHTML() );
1656 }
1657
1658 /**
1659 * @covers OutputPage::wrapWikiMsg
1660 */
1661 public function testWrapWikiMsg() {
1662 $msg = wfMessage( 'parentheses' );
1663 $this->assertSame( '(a)', $msg->rawParams( 'a' )->plain() );
1664
1665 $op = $this->newInstance();
1666 $this->assertSame( '', $op->getHTML() );
1667 $op->wrapWikiMsg( '[$1]', [ 'parentheses', "<b>a" ] );
1668 // This is known to be bad unbalanced HTML; this will be fixed
1669 // by I743f4185a03403f8d9b9db010ff1ee4e9342e062 (T198214)
1670 $this->assertSame( "<p>[(<b>a)]\n</p>", $op->getHTML() );
1671 }
1672
1673 /**
1674 * @covers OutputPage::addParserOutputMetadata
1675 * @covers OutputPage::addParserOutput
1676 */
1677 public function testNoGallery() {
1678 $op = $this->newInstance();
1679 $this->assertFalse( $op->mNoGallery );
1680
1681 $stubPO1 = $this->createParserOutputStub( 'getNoGallery', true );
1682 $op->addParserOutputMetadata( $stubPO1 );
1683 $this->assertTrue( $op->mNoGallery );
1684
1685 $stubPO2 = $this->createParserOutputStub( 'getNoGallery', false );
1686 $op->addParserOutput( $stubPO2 );
1687 $this->assertFalse( $op->mNoGallery );
1688 }
1689
1690 private static $parserOutputHookCalled;
1691
1692 /**
1693 * @covers OutputPage::addParserOutputMetadata
1694 */
1695 public function testParserOutputHooks() {
1696 $op = $this->newInstance();
1697 $pOut = $this->createParserOutputStub( 'getOutputHooks', [
1698 [ 'myhook', 'banana' ],
1699 [ 'yourhook', 'kumquat' ],
1700 [ 'theirhook', 'hippopotamus' ],
1701 ] );
1702
1703 self::$parserOutputHookCalled = [];
1704
1705 $this->setMwGlobals( 'wgParserOutputHooks', [
1706 'myhook' => function ( OutputPage $innerOp, ParserOutput $innerPOut, $data )
1707 use ( $op, $pOut ) {
1708 $this->assertSame( $op, $innerOp );
1709 $this->assertSame( $pOut, $innerPOut );
1710 $this->assertSame( 'banana', $data );
1711 self::$parserOutputHookCalled[] = 'closure';
1712 },
1713 'yourhook' => [ $this, 'parserOutputHookCallback' ],
1714 'theirhook' => [ __CLASS__, 'parserOutputHookCallbackStatic' ],
1715 'uncalled' => function () {
1716 $this->assertTrue( false );
1717 },
1718 ] );
1719
1720 $op->addParserOutputMetadata( $pOut );
1721
1722 $this->assertSame( [ 'closure', 'callback', 'static' ], self::$parserOutputHookCalled );
1723 }
1724
1725 public function parserOutputHookCallback(
1726 OutputPage $op, ParserOutput $pOut, $data
1727 ) {
1728 $this->assertSame( 'kumquat', $data );
1729
1730 self::$parserOutputHookCalled[] = 'callback';
1731 }
1732
1733 public static function parserOutputHookCallbackStatic(
1734 OutputPage $op, ParserOutput $pOut, $data
1735 ) {
1736 // All the assert methods are actually static, who knew!
1737 self::assertSame( 'hippopotamus', $data );
1738
1739 self::$parserOutputHookCalled[] = 'static';
1740 }
1741
1742 // @todo Make sure to test the following in addParserOutputMetadata() as well when we add tests
1743 // for them:
1744 // * addModules()
1745 // * addModuleScripts()
1746 // * addModuleStyles()
1747 // * addJsConfigVars()
1748 // * enableOOUI()
1749 // Otherwise those lines of addParserOutputMetadata() will be reported as covered, but we won't
1750 // be testing they actually work.
1751
1752 /**
1753 * @covers OutputPage::addParserOutputText
1754 */
1755 public function testAddParserOutputText() {
1756 $op = $this->newInstance();
1757 $this->assertSame( '', $op->getHTML() );
1758
1759 $pOut = $this->createParserOutputStub( 'getText', '<some text>' );
1760
1761 $op->addParserOutputMetadata( $pOut );
1762 $this->assertSame( '', $op->getHTML() );
1763
1764 $op->addParserOutputText( $pOut );
1765 $this->assertSame( '<some text>', $op->getHTML() );
1766 }
1767
1768 /**
1769 * @covers OutputPage::addParserOutput
1770 */
1771 public function testAddParserOutput() {
1772 $op = $this->newInstance();
1773 $this->assertSame( '', $op->getHTML() );
1774 $this->assertFalse( $op->showNewSectionLink() );
1775
1776 $pOut = $this->createParserOutputStub( [
1777 'getText' => '<some text>',
1778 'getNewSection' => true,
1779 ] );
1780
1781 $op->addParserOutput( $pOut );
1782 $this->assertSame( '<some text>', $op->getHTML() );
1783 $this->assertTrue( $op->showNewSectionLink() );
1784 }
1785
1786 /**
1787 * @covers OutputPage::addTemplate
1788 */
1789 public function testAddTemplate() {
1790 $template = $this->getMock( QuickTemplate::class );
1791 $template->method( 'getHTML' )->willReturn( '<abc>&def;' );
1792
1793 $op = $this->newInstance();
1794 $op->addTemplate( $template );
1795
1796 $this->assertSame( '<abc>&def;', $op->getHTML() );
1797 }
1798
1799 /**
1800 * @dataProvider provideParse
1801 * @covers OutputPage::parse
1802 * @param array $args To pass to parse()
1803 * @param string $expectedHTML Expected return value for parse()
1804 * @param string $expectedHTML Expected return value for parseInline(), if different
1805 */
1806 public function testParse( array $args, $expectedHTML ) {
1807 $op = $this->newInstance();
1808 $this->assertSame( $expectedHTML, $op->parse( ...$args ) );
1809 }
1810
1811 /**
1812 * @dataProvider provideParse
1813 * @covers OutputPage::parseInline
1814 */
1815 public function testParseInline( array $args, $expectedHTML, $expectedHTMLInline = null ) {
1816 if ( count( $args ) > 3 ) {
1817 // $language param not supported
1818 $this->assertTrue( true );
1819 return;
1820 }
1821 $op = $this->newInstance();
1822 $this->assertSame( $expectedHTMLInline ?? $expectedHTML, $op->parseInline( ...$args ) );
1823 }
1824
1825 public function provideParse() {
1826 return [
1827 'List at start of line' => [
1828 [ '* List' ],
1829 "<div class=\"mw-parser-output\"><ul><li>List</li></ul>\n</div>",
1830 ],
1831 'List not at start' => [
1832 [ "* ''Not'' list", false ],
1833 '<div class="mw-parser-output">* <i>Not</i> list</div>',
1834 ],
1835 'Interface' => [
1836 [ "''Italic''", true, true ],
1837 "<p><i>Italic</i>\n</p>",
1838 '<i>Italic</i>',
1839 ],
1840 'formatnum' => [
1841 [ '{{formatnum:123456.789}}' ],
1842 "<div class=\"mw-parser-output\"><p>123,456.789\n</p></div>",
1843 ],
1844 'Language' => [
1845 [ '{{formatnum:123456.789}}', true, false, Language::factory( 'is' ) ],
1846 "<div class=\"mw-parser-output\"><p>123.456,789\n</p></div>",
1847 ],
1848 'Language with interface' => [
1849 [ '{{formatnum:123456.789}}', true, true, Language::factory( 'is' ) ],
1850 "<p>123.456,789\n</p>",
1851 '123.456,789',
1852 ],
1853 'No section edit links' => [
1854 [ '== Header ==' ],
1855 '<div class="mw-parser-output"><h2><span class="mw-headline" id="Header">' .
1856 "Header</span></h2>\n</div>",
1857 ]
1858 ];
1859 }
1860
1861 /**
1862 * @covers OutputPage::parse
1863 */
1864 public function testParseNullTitle() {
1865 $this->setExpectedException( MWException::class, 'Empty $mTitle in OutputPage::parse' );
1866 $op = $this->newInstance( [], null, 'notitle' );
1867 $op->parse( '' );
1868 }
1869
1870 /**
1871 * @covers OutputPage::parse
1872 */
1873 public function testParseInlineNullTitle() {
1874 $this->setExpectedException( MWException::class, 'Empty $mTitle in OutputPage::parse' );
1875 $op = $this->newInstance( [], null, 'notitle' );
1876 $op->parseInline( '' );
1877 }
1878
1879 /**
1880 * @covers OutputPage::setCdnMaxage
1881 * @covers OutputPage::lowerCdnMaxage
1882 */
1883 public function testCdnMaxage() {
1884 $op = $this->newInstance();
1885 $wrapper = TestingAccessWrapper::newFromObject( $op );
1886 $this->assertSame( 0, $wrapper->mCdnMaxage );
1887
1888 $op->setCdnMaxage( -1 );
1889 $this->assertSame( -1, $wrapper->mCdnMaxage );
1890
1891 $op->setCdnMaxage( 120 );
1892 $this->assertSame( 120, $wrapper->mCdnMaxage );
1893
1894 $op->setCdnMaxage( 60 );
1895 $this->assertSame( 60, $wrapper->mCdnMaxage );
1896
1897 $op->setCdnMaxage( 180 );
1898 $this->assertSame( 180, $wrapper->mCdnMaxage );
1899
1900 $op->lowerCdnMaxage( 240 );
1901 $this->assertSame( 180, $wrapper->mCdnMaxage );
1902
1903 $op->setCdnMaxage( 300 );
1904 $this->assertSame( 240, $wrapper->mCdnMaxage );
1905
1906 $op->lowerCdnMaxage( 120 );
1907 $this->assertSame( 120, $wrapper->mCdnMaxage );
1908
1909 $op->setCdnMaxage( 180 );
1910 $this->assertSame( 120, $wrapper->mCdnMaxage );
1911
1912 $op->setCdnMaxage( 60 );
1913 $this->assertSame( 60, $wrapper->mCdnMaxage );
1914
1915 $op->setCdnMaxage( 240 );
1916 $this->assertSame( 120, $wrapper->mCdnMaxage );
1917 }
1918
1919 /** @var int Faked time to set for tests that need it */
1920 private static $fakeTime;
1921
1922 /**
1923 * @dataProvider provideAdaptCdnTTL
1924 * @covers OutputPage::adaptCdnTTL
1925 * @param array $args To pass to adaptCdnTTL()
1926 * @param int $expected Expected new value of mCdnMaxageLimit
1927 * @param array $options Associative array:
1928 * initialMaxage => Maxage to set before calling adaptCdnTTL() (default 86400)
1929 */
1930 public function testAdaptCdnTTL( array $args, $expected, array $options = [] ) {
1931 try {
1932 MWTimestamp::setFakeTime( self::$fakeTime );
1933
1934 $op = $this->newInstance();
1935 // Set a high maxage so that it will get reduced by adaptCdnTTL(). The default maxage
1936 // is 0, so adaptCdnTTL() won't mutate the object at all.
1937 $initial = $options['initialMaxage'] ?? 86400;
1938 $op->setCdnMaxage( $initial );
1939
1940 $op->adaptCdnTTL( ...$args );
1941 } finally {
1942 MWTimestamp::setFakeTime( false );
1943 }
1944
1945 $wrapper = TestingAccessWrapper::newFromObject( $op );
1946
1947 // Special rules for false/null
1948 if ( $args[0] === null || $args[0] === false ) {
1949 $this->assertSame( $initial, $wrapper->mCdnMaxage, 'member value' );
1950 $op->setCdnMaxage( $expected + 1 );
1951 $this->assertSame( $expected + 1, $wrapper->mCdnMaxage, 'member value after new set' );
1952 return;
1953 }
1954
1955 $this->assertSame( $expected, $wrapper->mCdnMaxageLimit, 'limit value' );
1956
1957 if ( $initial >= $expected ) {
1958 $this->assertSame( $expected, $wrapper->mCdnMaxage, 'member value' );
1959 } else {
1960 $this->assertSame( $initial, $wrapper->mCdnMaxage, 'member value' );
1961 }
1962
1963 $op->setCdnMaxage( $expected + 1 );
1964 $this->assertSame( $expected, $wrapper->mCdnMaxage, 'member value after new set' );
1965 }
1966
1967 public function provideAdaptCdnTTL() {
1968 global $wgSquidMaxage;
1969 $now = time();
1970 self::$fakeTime = $now;
1971 return [
1972 'Five minutes ago' => [ [ $now - 300 ], 270 ],
1973 'Now' => [ [ +0 ], IExpiringStore::TTL_MINUTE ],
1974 'Five minutes from now' => [ [ $now + 300 ], IExpiringStore::TTL_MINUTE ],
1975 'Five minutes ago, initial maxage four minutes' =>
1976 [ [ $now - 300 ], 270, [ 'initialMaxage' => 240 ] ],
1977 'A very long time ago' => [ [ $now - 1000000000 ], $wgSquidMaxage ],
1978 'Initial maxage zero' => [ [ $now - 300 ], 270, [ 'initialMaxage' => 0 ] ],
1979
1980 'false' => [ [ false ], IExpiringStore::TTL_MINUTE ],
1981 'null' => [ [ null ], IExpiringStore::TTL_MINUTE ],
1982 "'0'" => [ [ '0' ], IExpiringStore::TTL_MINUTE ],
1983 'Empty string' => [ [ '' ], IExpiringStore::TTL_MINUTE ],
1984 // @todo These give incorrect results due to timezones, how to test?
1985 //"'now'" => [ [ 'now' ], IExpiringStore::TTL_MINUTE ],
1986 //"'parse error'" => [ [ 'parse error' ], IExpiringStore::TTL_MINUTE ],
1987
1988 'Now, minTTL 0' => [ [ $now, 0 ], IExpiringStore::TTL_MINUTE ],
1989 'Now, minTTL 0.000001' => [ [ $now, 0.000001 ], 0 ],
1990 'A very long time ago, maxTTL even longer' =>
1991 [ [ $now - 1000000000, 0, 1000000001 ], 900000000 ],
1992 ];
1993 }
1994
1995 /**
1996 * @covers OutputPage::enableClientCache
1997 * @covers OutputPage::addParserOutputMetadata
1998 * @covers OutputPage::addParserOutput
1999 */
2000 public function testClientCache() {
2001 $op = $this->newInstance();
2002
2003 // Test initial value
2004 $this->assertSame( true, $op->enableClientCache( null ) );
2005 // Test that calling with null doesn't change the value
2006 $this->assertSame( true, $op->enableClientCache( null ) );
2007
2008 // Test setting to false
2009 $this->assertSame( true, $op->enableClientCache( false ) );
2010 $this->assertSame( false, $op->enableClientCache( null ) );
2011 // Test that calling with null doesn't change the value
2012 $this->assertSame( false, $op->enableClientCache( null ) );
2013
2014 // Test that a cacheable ParserOutput doesn't set to true
2015 $pOutCacheable = $this->createParserOutputStub( 'isCacheable', true );
2016 $op->addParserOutputMetadata( $pOutCacheable );
2017 $this->assertSame( false, $op->enableClientCache( null ) );
2018
2019 // Test setting back to true
2020 $this->assertSame( false, $op->enableClientCache( true ) );
2021 $this->assertSame( true, $op->enableClientCache( null ) );
2022
2023 // Test that an uncacheable ParserOutput does set to false
2024 $pOutUncacheable = $this->createParserOutputStub( 'isCacheable', false );
2025 $op->addParserOutput( $pOutUncacheable );
2026 $this->assertSame( false, $op->enableClientCache( null ) );
2027 }
2028
2029 /**
2030 * @covers OutputPage::getCacheVaryCookies
2031 */
2032 public function testGetCacheVaryCookies() {
2033 global $wgCookiePrefix, $wgDBname;
2034 $op = $this->newInstance();
2035 $prefix = $wgCookiePrefix !== false ? $wgCookiePrefix : $wgDBname;
2036 $expectedCookies = [
2037 "{$prefix}Token",
2038 "{$prefix}LoggedOut",
2039 "{$prefix}_session",
2040 'forceHTTPS',
2041 'cookie1',
2042 'cookie2',
2043 ];
2044
2045 // We have to reset the cookies because getCacheVaryCookies may have already been called
2046 TestingAccessWrapper::newFromClass( OutputPage::class )->cacheVaryCookies = null;
2047
2048 $this->setMwGlobals( 'wgCacheVaryCookies', [ 'cookie1' ] );
2049 $this->setTemporaryHook( 'GetCacheVaryCookies',
2050 function ( $innerOP, &$cookies ) use ( $op, $expectedCookies ) {
2051 $this->assertSame( $op, $innerOP );
2052 $cookies[] = 'cookie2';
2053 $this->assertSame( $expectedCookies, $cookies );
2054 }
2055 );
2056
2057 $this->assertSame( $expectedCookies, $op->getCacheVaryCookies() );
2058 }
2059
2060 /**
2061 * @covers OutputPage::haveCacheVaryCookies
2062 */
2063 public function testHaveCacheVaryCookies() {
2064 $request = new FauxRequest();
2065 $op = $this->newInstance( [], $request );
2066
2067 // No cookies are set.
2068 $this->assertFalse( $op->haveCacheVaryCookies() );
2069
2070 // 'Token' is present but empty, so it shouldn't count.
2071 $request->setCookie( 'Token', '' );
2072 $this->assertFalse( $op->haveCacheVaryCookies() );
2073
2074 // 'Token' present and nonempty.
2075 $request->setCookie( 'Token', '123' );
2076 $this->assertTrue( $op->haveCacheVaryCookies() );
2077 }
2078
2079 /**
2080 * @dataProvider provideVaryHeaders
2081 *
2082 * @covers OutputPage::addVaryHeader
2083 * @covers OutputPage::getVaryHeader
2084 * @covers OutputPage::getKeyHeader
2085 *
2086 * @param array[] $calls For each array, call addVaryHeader() with those arguments
2087 * @param string[] $cookies Array of cookie names to vary on
2088 * @param string $vary Text of expected Vary header (including the 'Vary: ')
2089 * @param string $key Text of expected Key header (including the 'Key: ')
2090 */
2091 public function testVaryHeaders( array $calls, array $cookies, $vary, $key ) {
2092 // Get rid of default Vary fields
2093 $op = $this->getMockBuilder( OutputPage::class )
2094 ->setConstructorArgs( [ new RequestContext() ] )
2095 ->setMethods( [ 'getCacheVaryCookies' ] )
2096 ->getMock();
2097 $op->expects( $this->any() )
2098 ->method( 'getCacheVaryCookies' )
2099 ->will( $this->returnValue( $cookies ) );
2100 TestingAccessWrapper::newFromObject( $op )->mVaryHeader = [];
2101
2102 $this->hideDeprecated( '$wgUseKeyHeader' );
2103 foreach ( $calls as $call ) {
2104 $op->addVaryHeader( ...$call );
2105 }
2106 $this->assertEquals( $vary, $op->getVaryHeader(), 'Vary:' );
2107 $this->assertEquals( $key, $op->getKeyHeader(), 'Key:' );
2108 }
2109
2110 public function provideVaryHeaders() {
2111 // note: getKeyHeader() automatically adds Vary: Cookie
2112 return [
2113 'No header' => [
2114 [],
2115 [],
2116 'Vary: ',
2117 'Key: Cookie',
2118 ],
2119 'Single header' => [
2120 [
2121 [ 'Cookie' ],
2122 ],
2123 [],
2124 'Vary: Cookie',
2125 'Key: Cookie',
2126 ],
2127 'Non-unique headers' => [
2128 [
2129 [ 'Cookie' ],
2130 [ 'Accept-Language' ],
2131 [ 'Cookie' ],
2132 ],
2133 [],
2134 'Vary: Cookie, Accept-Language',
2135 'Key: Cookie,Accept-Language',
2136 ],
2137 'Two headers with single options' => [
2138 [
2139 [ 'Cookie', [ 'param=phpsessid' ] ],
2140 [ 'Accept-Language', [ 'substr=en' ] ],
2141 ],
2142 [],
2143 'Vary: Cookie, Accept-Language',
2144 'Key: Cookie;param=phpsessid,Accept-Language;substr=en',
2145 ],
2146 'One header with multiple options' => [
2147 [
2148 [ 'Cookie', [ 'param=phpsessid', 'param=userId' ] ],
2149 ],
2150 [],
2151 'Vary: Cookie',
2152 'Key: Cookie;param=phpsessid;param=userId',
2153 ],
2154 'Duplicate option' => [
2155 [
2156 [ 'Cookie', [ 'param=phpsessid' ] ],
2157 [ 'Cookie', [ 'param=phpsessid' ] ],
2158 [ 'Accept-Language', [ 'substr=en', 'substr=en' ] ],
2159 ],
2160 [],
2161 'Vary: Cookie, Accept-Language',
2162 'Key: Cookie;param=phpsessid,Accept-Language;substr=en',
2163 ],
2164 'Same header, different options' => [
2165 [
2166 [ 'Cookie', [ 'param=phpsessid' ] ],
2167 [ 'Cookie', [ 'param=userId' ] ],
2168 ],
2169 [],
2170 'Vary: Cookie',
2171 'Key: Cookie;param=phpsessid;param=userId',
2172 ],
2173 'No header, vary cookies' => [
2174 [],
2175 [ 'cookie1', 'cookie2' ],
2176 'Vary: Cookie',
2177 'Key: Cookie;param=cookie1;param=cookie2',
2178 ],
2179 'Cookie header with option plus vary cookies' => [
2180 [
2181 [ 'Cookie', [ 'param=cookie1' ] ],
2182 ],
2183 [ 'cookie2', 'cookie3' ],
2184 'Vary: Cookie',
2185 'Key: Cookie;param=cookie1;param=cookie2;param=cookie3',
2186 ],
2187 'Non-cookie header plus vary cookies' => [
2188 [
2189 [ 'Accept-Language' ],
2190 ],
2191 [ 'cookie' ],
2192 'Vary: Accept-Language, Cookie',
2193 'Key: Accept-Language,Cookie;param=cookie',
2194 ],
2195 'Cookie and non-cookie headers plus vary cookies' => [
2196 [
2197 [ 'Cookie', [ 'param=cookie1' ] ],
2198 [ 'Accept-Language' ],
2199 ],
2200 [ 'cookie2' ],
2201 'Vary: Cookie, Accept-Language',
2202 'Key: Cookie;param=cookie1;param=cookie2,Accept-Language',
2203 ],
2204 ];
2205 }
2206
2207 /**
2208 * @covers OutputPage::getVaryHeader
2209 */
2210 public function testVaryHeaderDefault() {
2211 $op = $this->newInstance();
2212 $this->assertSame( 'Vary: Accept-Encoding, Cookie', $op->getVaryHeader() );
2213 }
2214
2215 /**
2216 * @dataProvider provideLinkHeaders
2217 *
2218 * @covers OutputPage::addLinkHeader
2219 * @covers OutputPage::getLinkHeader
2220 */
2221 public function testLinkHeaders( array $headers, $result ) {
2222 $op = $this->newInstance();
2223
2224 foreach ( $headers as $header ) {
2225 $op->addLinkHeader( $header );
2226 }
2227
2228 $this->assertEquals( $result, $op->getLinkHeader() );
2229 }
2230
2231 public function provideLinkHeaders() {
2232 return [
2233 [
2234 [],
2235 false
2236 ],
2237 [
2238 [ '<https://foo/bar.jpg>;rel=preload;as=image' ],
2239 'Link: <https://foo/bar.jpg>;rel=preload;as=image',
2240 ],
2241 [
2242 [
2243 '<https://foo/bar.jpg>;rel=preload;as=image',
2244 '<https://foo/baz.jpg>;rel=preload;as=image'
2245 ],
2246 'Link: <https://foo/bar.jpg>;rel=preload;as=image,<https://foo/baz.jpg>;' .
2247 'rel=preload;as=image',
2248 ],
2249 ];
2250 }
2251
2252 /**
2253 * @dataProvider provideAddAcceptLanguage
2254 * @covers OutputPage::addAcceptLanguage
2255 * @covers OutputPage::getKeyHeader
2256 */
2257 public function testAddAcceptLanguage(
2258 $code, array $variants, array $expected, array $options = []
2259 ) {
2260 $req = new FauxRequest( in_array( 'varianturl', $options ) ? [ 'variant' => 'x' ] : [] );
2261 $op = $this->newInstance( [], $req, in_array( 'notitle', $options ) ? 'notitle' : null );
2262
2263 if ( !in_array( 'notitle', $options ) ) {
2264 $mockLang = $this->getMock( Language::class );
2265
2266 if ( in_array( 'varianturl', $options ) ) {
2267 $mockLang->expects( $this->never() )->method( $this->anything() );
2268 } else {
2269 $mockLang->method( 'hasVariants' )->willReturn( count( $variants ) > 1 );
2270 $mockLang->method( 'getVariants' )->willReturn( $variants );
2271 $mockLang->method( 'getCode' )->willReturn( $code );
2272 }
2273
2274 $mockTitle = $this->getMock( Title::class );
2275 $mockTitle->method( 'getPageLanguage' )->willReturn( $mockLang );
2276
2277 $op->setTitle( $mockTitle );
2278 }
2279
2280 // This will run addAcceptLanguage()
2281 $op->sendCacheControl();
2282
2283 $this->hideDeprecated( '$wgUseKeyHeader' );
2284 $keyHeader = $op->getKeyHeader();
2285
2286 if ( !$expected ) {
2287 $this->assertFalse( strpos( 'Accept-Language', $keyHeader ) );
2288 return;
2289 }
2290
2291 $keyHeader = explode( ' ', $keyHeader, 2 )[1];
2292 $keyHeader = explode( ',', $keyHeader );
2293
2294 $acceptLanguage = null;
2295 foreach ( $keyHeader as $item ) {
2296 if ( strpos( $item, 'Accept-Language;' ) === 0 ) {
2297 $acceptLanguage = $item;
2298 break;
2299 }
2300 }
2301
2302 $expectedString = 'Accept-Language;substr=' . implode( ';substr=', $expected );
2303 $this->assertSame( $expectedString, $acceptLanguage );
2304 }
2305
2306 public function provideAddAcceptLanguage() {
2307 return [
2308 'No variants' => [ 'en', [ 'en' ], [] ],
2309 'One simple variant' => [ 'en', [ 'en', 'en-x-piglatin' ], [ 'en-x-piglatin' ] ],
2310 'Multiple variants with BCP47 alternatives' => [
2311 'zh',
2312 [ 'zh', 'zh-hans', 'zh-cn', 'zh-tw' ],
2313 [ 'zh-hans', 'zh-Hans', 'zh-cn', 'zh-Hans-CN', 'zh-tw', 'zh-Hant-TW' ],
2314 ],
2315 'No title' => [ 'en', [ 'en', 'en-x-piglatin' ], [], [ 'notitle' ] ],
2316 'Variant in URL' => [ 'en', [ 'en', 'en-x-piglatin' ], [], [ 'varianturl' ] ],
2317 ];
2318 }
2319
2320 /**
2321 * @covers OutputPage::preventClickjacking
2322 * @covers OutputPage::allowClickjacking
2323 * @covers OutputPage::getPreventClickjacking
2324 * @covers OutputPage::addParserOutputMetadata
2325 * @covers OutputPage::addParserOutput
2326 */
2327 public function testClickjacking() {
2328 $op = $this->newInstance();
2329 $this->assertTrue( $op->getPreventClickjacking() );
2330
2331 $op->allowClickjacking();
2332 $this->assertFalse( $op->getPreventClickjacking() );
2333
2334 $op->preventClickjacking();
2335 $this->assertTrue( $op->getPreventClickjacking() );
2336
2337 $op->preventClickjacking( false );
2338 $this->assertFalse( $op->getPreventClickjacking() );
2339
2340 $pOut1 = $this->createParserOutputStub( 'preventClickjacking', true );
2341 $op->addParserOutputMetadata( $pOut1 );
2342 $this->assertTrue( $op->getPreventClickjacking() );
2343
2344 // The ParserOutput can't allow, only prevent
2345 $pOut2 = $this->createParserOutputStub( 'preventClickjacking', false );
2346 $op->addParserOutputMetadata( $pOut2 );
2347 $this->assertTrue( $op->getPreventClickjacking() );
2348
2349 // Reset to test with addParserOutput()
2350 $op->allowClickjacking();
2351 $this->assertFalse( $op->getPreventClickjacking() );
2352
2353 $op->addParserOutput( $pOut1 );
2354 $this->assertTrue( $op->getPreventClickjacking() );
2355
2356 $op->addParserOutput( $pOut2 );
2357 $this->assertTrue( $op->getPreventClickjacking() );
2358 }
2359
2360 /**
2361 * @dataProvider provideGetFrameOptions
2362 * @covers OutputPage::getFrameOptions
2363 * @covers OutputPage::preventClickjacking
2364 */
2365 public function testGetFrameOptions(
2366 $breakFrames, $preventClickjacking, $editPageFrameOptions, $expected
2367 ) {
2368 $op = $this->newInstance( [
2369 'BreakFrames' => $breakFrames,
2370 'EditPageFrameOptions' => $editPageFrameOptions,
2371 ] );
2372 $op->preventClickjacking( $preventClickjacking );
2373
2374 $this->assertSame( $expected, $op->getFrameOptions() );
2375 }
2376
2377 public function provideGetFrameOptions() {
2378 return [
2379 'BreakFrames true' => [ true, false, false, 'DENY' ],
2380 'Allow clickjacking locally' => [ false, false, 'DENY', false ],
2381 'Allow clickjacking globally' => [ false, true, false, false ],
2382 'DENY globally' => [ false, true, 'DENY', 'DENY' ],
2383 'SAMEORIGIN' => [ false, true, 'SAMEORIGIN', 'SAMEORIGIN' ],
2384 'BreakFrames with SAMEORIGIN' => [ true, true, 'SAMEORIGIN', 'DENY' ],
2385 ];
2386 }
2387
2388 /**
2389 * See ResourceLoaderClientHtmlTest for full coverage.
2390 *
2391 * @dataProvider provideMakeResourceLoaderLink
2392 *
2393 * @covers OutputPage::makeResourceLoaderLink
2394 */
2395 public function testMakeResourceLoaderLink( $args, $expectedHtml ) {
2396 $this->setMwGlobals( [
2397 'wgResourceLoaderDebug' => false,
2398 'wgLoadScript' => 'http://127.0.0.1:8080/w/load.php',
2399 'wgCSPReportOnlyHeader' => true,
2400 ] );
2401 $class = new ReflectionClass( OutputPage::class );
2402 $method = $class->getMethod( 'makeResourceLoaderLink' );
2403 $method->setAccessible( true );
2404 $ctx = new RequestContext();
2405 $ctx->setSkin( SkinFactory::getDefaultInstance()->makeSkin( 'fallback' ) );
2406 $ctx->setLanguage( 'en' );
2407 $out = new OutputPage( $ctx );
2408 $nonce = $class->getProperty( 'CSPNonce' );
2409 $nonce->setAccessible( true );
2410 $nonce->setValue( $out, 'secret' );
2411 $rl = $out->getResourceLoader();
2412 $rl->setMessageBlobStore( new NullMessageBlobStore() );
2413 $rl->register( [
2414 'test.foo' => new ResourceLoaderTestModule( [
2415 'script' => 'mw.test.foo( { a: true } );',
2416 'styles' => '.mw-test-foo { content: "style"; }',
2417 ] ),
2418 'test.bar' => new ResourceLoaderTestModule( [
2419 'script' => 'mw.test.bar( { a: true } );',
2420 'styles' => '.mw-test-bar { content: "style"; }',
2421 ] ),
2422 'test.baz' => new ResourceLoaderTestModule( [
2423 'script' => 'mw.test.baz( { a: true } );',
2424 'styles' => '.mw-test-baz { content: "style"; }',
2425 ] ),
2426 'test.quux' => new ResourceLoaderTestModule( [
2427 'script' => 'mw.test.baz( { token: 123 } );',
2428 'styles' => '/* pref-animate=off */ .mw-icon { transition: none; }',
2429 'group' => 'private',
2430 ] ),
2431 'test.noscript' => new ResourceLoaderTestModule( [
2432 'styles' => '.stuff { color: red; }',
2433 'group' => 'noscript',
2434 ] ),
2435 'test.group.foo' => new ResourceLoaderTestModule( [
2436 'script' => 'mw.doStuff( "foo" );',
2437 'group' => 'foo',
2438 ] ),
2439 'test.group.bar' => new ResourceLoaderTestModule( [
2440 'script' => 'mw.doStuff( "bar" );',
2441 'group' => 'bar',
2442 ] ),
2443 ] );
2444 $links = $method->invokeArgs( $out, $args );
2445 $actualHtml = strval( $links );
2446 $this->assertEquals( $expectedHtml, $actualHtml );
2447 }
2448
2449 public static function provideMakeResourceLoaderLink() {
2450 // phpcs:disable Generic.Files.LineLength
2451 return [
2452 // Single only=scripts load
2453 [
2454 [ 'test.foo', ResourceLoaderModule::TYPE_SCRIPTS ],
2455 "<script nonce=\"secret\">(window.RLQ=window.RLQ||[]).push(function(){"
2456 . 'mw.loader.load("http://127.0.0.1:8080/w/load.php?debug=false\u0026lang=en\u0026modules=test.foo\u0026only=scripts\u0026skin=fallback");'
2457 . "});</script>"
2458 ],
2459 // Multiple only=styles load
2460 [
2461 [ [ 'test.baz', 'test.foo', 'test.bar' ], ResourceLoaderModule::TYPE_STYLES ],
2462
2463 '<link rel="stylesheet" href="http://127.0.0.1:8080/w/load.php?debug=false&amp;lang=en&amp;modules=test.bar%2Cbaz%2Cfoo&amp;only=styles&amp;skin=fallback"/>'
2464 ],
2465 // Private embed (only=scripts)
2466 [
2467 [ 'test.quux', ResourceLoaderModule::TYPE_SCRIPTS ],
2468 "<script nonce=\"secret\">(window.RLQ=window.RLQ||[]).push(function(){"
2469 . "mw.test.baz({token:123});\nmw.loader.state({\"test.quux\":\"ready\"});"
2470 . "});</script>"
2471 ],
2472 // Load private module (combined)
2473 [
2474 [ 'test.quux', ResourceLoaderModule::TYPE_COMBINED ],
2475 "<script nonce=\"secret\">(window.RLQ=window.RLQ||[]).push(function(){"
2476 . "mw.loader.implement(\"test.quux@1ev0ijv\",function($,jQuery,require,module){"
2477 . "mw.test.baz({token:123});},{\"css\":[\".mw-icon{transition:none}"
2478 . "\"]});});</script>"
2479 ],
2480 // Load no modules
2481 [
2482 [ [], ResourceLoaderModule::TYPE_COMBINED ],
2483 '',
2484 ],
2485 // noscript group
2486 [
2487 [ 'test.noscript', ResourceLoaderModule::TYPE_STYLES ],
2488 '<noscript><link rel="stylesheet" href="http://127.0.0.1:8080/w/load.php?debug=false&amp;lang=en&amp;modules=test.noscript&amp;only=styles&amp;skin=fallback"/></noscript>'
2489 ],
2490 // Load two modules in separate groups
2491 [
2492 [ [ 'test.group.foo', 'test.group.bar' ], ResourceLoaderModule::TYPE_COMBINED ],
2493 "<script nonce=\"secret\">(window.RLQ=window.RLQ||[]).push(function(){"
2494 . 'mw.loader.load("http://127.0.0.1:8080/w/load.php?debug=false\u0026lang=en\u0026modules=test.group.bar\u0026skin=fallback");'
2495 . 'mw.loader.load("http://127.0.0.1:8080/w/load.php?debug=false\u0026lang=en\u0026modules=test.group.foo\u0026skin=fallback");'
2496 . "});</script>"
2497 ],
2498 ];
2499 // phpcs:enable
2500 }
2501
2502 /**
2503 * @dataProvider provideBuildExemptModules
2504 *
2505 * @covers OutputPage::buildExemptModules
2506 */
2507 public function testBuildExemptModules( array $exemptStyleModules, $expect ) {
2508 $this->setMwGlobals( [
2509 'wgResourceLoaderDebug' => false,
2510 'wgLoadScript' => '/w/load.php',
2511 // Stub wgCacheEpoch as it influences getVersionHash used for the
2512 // urls in the expected HTML
2513 'wgCacheEpoch' => '20140101000000',
2514 ] );
2515
2516 // Set up stubs
2517 $ctx = new RequestContext();
2518 $ctx->setSkin( SkinFactory::getDefaultInstance()->makeSkin( 'fallback' ) );
2519 $ctx->setLanguage( 'en' );
2520 $op = $this->getMockBuilder( OutputPage::class )
2521 ->setConstructorArgs( [ $ctx ] )
2522 ->setMethods( [ 'buildCssLinksArray' ] )
2523 ->getMock();
2524 $op->expects( $this->any() )
2525 ->method( 'buildCssLinksArray' )
2526 ->willReturn( [] );
2527 $rl = $op->getResourceLoader();
2528 $rl->setMessageBlobStore( new NullMessageBlobStore() );
2529
2530 // Register custom modules
2531 $rl->register( [
2532 'example.site.a' => new ResourceLoaderTestModule( [ 'group' => 'site' ] ),
2533 'example.site.b' => new ResourceLoaderTestModule( [ 'group' => 'site' ] ),
2534 'example.user' => new ResourceLoaderTestModule( [ 'group' => 'user' ] ),
2535 ] );
2536
2537 $op = TestingAccessWrapper::newFromObject( $op );
2538 $op->rlExemptStyleModules = $exemptStyleModules;
2539 $this->assertEquals(
2540 $expect,
2541 strval( $op->buildExemptModules() )
2542 );
2543 }
2544
2545 public static function provideBuildExemptModules() {
2546 // phpcs:disable Generic.Files.LineLength
2547 return [
2548 'empty' => [
2549 'exemptStyleModules' => [],
2550 '<meta name="ResourceLoaderDynamicStyles" content=""/>',
2551 ],
2552 'empty sets' => [
2553 'exemptStyleModules' => [ 'site' => [], 'noscript' => [], 'private' => [], 'user' => [] ],
2554 '<meta name="ResourceLoaderDynamicStyles" content=""/>',
2555 ],
2556 'default logged-out' => [
2557 'exemptStyleModules' => [ 'site' => [ 'site.styles' ] ],
2558 '<meta name="ResourceLoaderDynamicStyles" content=""/>' . "\n" .
2559 '<link rel="stylesheet" href="/w/load.php?debug=false&amp;lang=en&amp;modules=site.styles&amp;only=styles&amp;skin=fallback"/>',
2560 ],
2561 'default logged-in' => [
2562 'exemptStyleModules' => [ 'site' => [ 'site.styles' ], 'user' => [ 'user.styles' ] ],
2563 '<meta name="ResourceLoaderDynamicStyles" content=""/>' . "\n" .
2564 '<link rel="stylesheet" href="/w/load.php?debug=false&amp;lang=en&amp;modules=site.styles&amp;only=styles&amp;skin=fallback"/>' . "\n" .
2565 '<link rel="stylesheet" href="/w/load.php?debug=false&amp;lang=en&amp;modules=user.styles&amp;only=styles&amp;skin=fallback&amp;version=1ai9g6t"/>',
2566 ],
2567 'custom modules' => [
2568 'exemptStyleModules' => [
2569 'site' => [ 'site.styles', 'example.site.a', 'example.site.b' ],
2570 'user' => [ 'user.styles', 'example.user' ],
2571 ],
2572 '<meta name="ResourceLoaderDynamicStyles" content=""/>' . "\n" .
2573 '<link rel="stylesheet" href="/w/load.php?debug=false&amp;lang=en&amp;modules=example.site.a%2Cb&amp;only=styles&amp;skin=fallback"/>' . "\n" .
2574 '<link rel="stylesheet" href="/w/load.php?debug=false&amp;lang=en&amp;modules=site.styles&amp;only=styles&amp;skin=fallback"/>' . "\n" .
2575 '<link rel="stylesheet" href="/w/load.php?debug=false&amp;lang=en&amp;modules=example.user&amp;only=styles&amp;skin=fallback&amp;version=0a56zyi"/>' . "\n" .
2576 '<link rel="stylesheet" href="/w/load.php?debug=false&amp;lang=en&amp;modules=user.styles&amp;only=styles&amp;skin=fallback&amp;version=1ai9g6t"/>',
2577 ],
2578 ];
2579 // phpcs:enable
2580 }
2581
2582 /**
2583 * @dataProvider provideTransformFilePath
2584 * @covers OutputPage::transformFilePath
2585 * @covers OutputPage::transformResourcePath
2586 */
2587 public function testTransformResourcePath( $baseDir, $basePath, $uploadDir = null,
2588 $uploadPath = null, $path = null, $expected = null
2589 ) {
2590 if ( $path === null ) {
2591 // Skip optional $uploadDir and $uploadPath
2592 $path = $uploadDir;
2593 $expected = $uploadPath;
2594 $uploadDir = "$baseDir/images";
2595 $uploadPath = "$basePath/images";
2596 }
2597 $this->setMwGlobals( 'IP', $baseDir );
2598 $conf = new HashConfig( [
2599 'ResourceBasePath' => $basePath,
2600 'UploadDirectory' => $uploadDir,
2601 'UploadPath' => $uploadPath,
2602 ] );
2603
2604 // Some of these paths don't exist and will cause warnings
2605 Wikimedia\suppressWarnings();
2606 $actual = OutputPage::transformResourcePath( $conf, $path );
2607 Wikimedia\restoreWarnings();
2608
2609 $this->assertEquals( $expected ?: $path, $actual );
2610 }
2611
2612 public static function provideTransformFilePath() {
2613 $baseDir = dirname( __DIR__ ) . '/data/media';
2614 return [
2615 // File that matches basePath, and exists. Hash found and appended.
2616 [
2617 'baseDir' => $baseDir, 'basePath' => '/w',
2618 '/w/test.jpg',
2619 '/w/test.jpg?edcf2'
2620 ],
2621 // File that matches basePath, but not found on disk. Empty query.
2622 [
2623 'baseDir' => $baseDir, 'basePath' => '/w',
2624 '/w/unknown.png',
2625 '/w/unknown.png?'
2626 ],
2627 // File not matching basePath. Ignored.
2628 [
2629 'baseDir' => $baseDir, 'basePath' => '/w',
2630 '/files/test.jpg'
2631 ],
2632 // Empty string. Ignored.
2633 [
2634 'baseDir' => $baseDir, 'basePath' => '/w',
2635 '',
2636 ''
2637 ],
2638 // Similar path, but with domain component. Ignored.
2639 [
2640 'baseDir' => $baseDir, 'basePath' => '/w',
2641 '//example.org/w/test.jpg'
2642 ],
2643 [
2644 'baseDir' => $baseDir, 'basePath' => '/w',
2645 'https://example.org/w/test.jpg'
2646 ],
2647 // Unrelated path with domain component. Ignored.
2648 [
2649 'baseDir' => $baseDir, 'basePath' => '/w',
2650 'https://example.org/files/test.jpg'
2651 ],
2652 [
2653 'baseDir' => $baseDir, 'basePath' => '/w',
2654 '//example.org/files/test.jpg'
2655 ],
2656 // Unrelated path with domain, and empty base path (root mw install). Ignored.
2657 [
2658 'baseDir' => $baseDir, 'basePath' => '',
2659 'https://example.org/files/test.jpg'
2660 ],
2661 [
2662 'baseDir' => $baseDir, 'basePath' => '',
2663 // T155310
2664 '//example.org/files/test.jpg'
2665 ],
2666 // Check UploadPath before ResourceBasePath (T155146)
2667 [
2668 'baseDir' => dirname( $baseDir ), 'basePath' => '',
2669 'uploadDir' => $baseDir, 'uploadPath' => '/images',
2670 '/images/test.jpg',
2671 '/images/test.jpg?edcf2'
2672 ],
2673 ];
2674 }
2675
2676 /**
2677 * Tests a particular case of transformCssMedia, using the given input, globals,
2678 * expected return, and message
2679 *
2680 * Asserts that $expectedReturn is returned.
2681 *
2682 * options['printableQuery'] - value of query string for printable, or omitted for none
2683 * options['handheldQuery'] - value of query string for handheld, or omitted for none
2684 * options['media'] - passed into the method under the same name
2685 * options['expectedReturn'] - expected return value
2686 * options['message'] - PHPUnit message for assertion
2687 *
2688 * @param array $args Key-value array of arguments as shown above
2689 */
2690 protected function assertTransformCssMediaCase( $args ) {
2691 $queryData = [];
2692 if ( isset( $args['printableQuery'] ) ) {
2693 $queryData['printable'] = $args['printableQuery'];
2694 }
2695
2696 if ( isset( $args['handheldQuery'] ) ) {
2697 $queryData['handheld'] = $args['handheldQuery'];
2698 }
2699
2700 $fauxRequest = new FauxRequest( $queryData, false );
2701 $this->setMwGlobals( [
2702 'wgRequest' => $fauxRequest,
2703 ] );
2704
2705 $actualReturn = OutputPage::transformCssMedia( $args['media'] );
2706 $this->assertSame( $args['expectedReturn'], $actualReturn, $args['message'] );
2707 }
2708
2709 /**
2710 * Tests print requests
2711 *
2712 * @covers OutputPage::transformCssMedia
2713 */
2714 public function testPrintRequests() {
2715 $this->assertTransformCssMediaCase( [
2716 'printableQuery' => '1',
2717 'media' => 'screen',
2718 'expectedReturn' => null,
2719 'message' => 'On printable request, screen returns null'
2720 ] );
2721
2722 $this->assertTransformCssMediaCase( [
2723 'printableQuery' => '1',
2724 'media' => self::SCREEN_MEDIA_QUERY,
2725 'expectedReturn' => null,
2726 'message' => 'On printable request, screen media query returns null'
2727 ] );
2728
2729 $this->assertTransformCssMediaCase( [
2730 'printableQuery' => '1',
2731 'media' => self::SCREEN_ONLY_MEDIA_QUERY,
2732 'expectedReturn' => null,
2733 'message' => 'On printable request, screen media query with only returns null'
2734 ] );
2735
2736 $this->assertTransformCssMediaCase( [
2737 'printableQuery' => '1',
2738 'media' => 'print',
2739 'expectedReturn' => '',
2740 'message' => 'On printable request, media print returns empty string'
2741 ] );
2742 }
2743
2744 /**
2745 * Tests screen requests, without either query parameter set
2746 *
2747 * @covers OutputPage::transformCssMedia
2748 */
2749 public function testScreenRequests() {
2750 $this->assertTransformCssMediaCase( [
2751 'media' => 'screen',
2752 'expectedReturn' => 'screen',
2753 'message' => 'On screen request, screen media type is preserved'
2754 ] );
2755
2756 $this->assertTransformCssMediaCase( [
2757 'media' => 'handheld',
2758 'expectedReturn' => 'handheld',
2759 'message' => 'On screen request, handheld media type is preserved'
2760 ] );
2761
2762 $this->assertTransformCssMediaCase( [
2763 'media' => self::SCREEN_MEDIA_QUERY,
2764 'expectedReturn' => self::SCREEN_MEDIA_QUERY,
2765 'message' => 'On screen request, screen media query is preserved.'
2766 ] );
2767
2768 $this->assertTransformCssMediaCase( [
2769 'media' => self::SCREEN_ONLY_MEDIA_QUERY,
2770 'expectedReturn' => self::SCREEN_ONLY_MEDIA_QUERY,
2771 'message' => 'On screen request, screen media query with only is preserved.'
2772 ] );
2773
2774 $this->assertTransformCssMediaCase( [
2775 'media' => 'print',
2776 'expectedReturn' => 'print',
2777 'message' => 'On screen request, print media type is preserved'
2778 ] );
2779 }
2780
2781 /**
2782 * Tests handheld behavior
2783 *
2784 * @covers OutputPage::transformCssMedia
2785 */
2786 public function testHandheld() {
2787 $this->assertTransformCssMediaCase( [
2788 'handheldQuery' => '1',
2789 'media' => 'handheld',
2790 'expectedReturn' => '',
2791 'message' => 'On request with handheld querystring and media is handheld, returns empty string'
2792 ] );
2793
2794 $this->assertTransformCssMediaCase( [
2795 'handheldQuery' => '1',
2796 'media' => 'screen',
2797 'expectedReturn' => null,
2798 'message' => 'On request with handheld querystring and media is screen, returns null'
2799 ] );
2800 }
2801
2802 /**
2803 * @covers OutputPage::isTOCEnabled
2804 * @covers OutputPage::addParserOutputMetadata
2805 * @covers OutputPage::addParserOutput
2806 */
2807 public function testIsTOCEnabled() {
2808 $op = $this->newInstance();
2809 $this->assertFalse( $op->isTOCEnabled() );
2810
2811 $pOut1 = $this->createParserOutputStub( 'getTOCHTML', false );
2812 $op->addParserOutputMetadata( $pOut1 );
2813 $this->assertFalse( $op->isTOCEnabled() );
2814
2815 $pOut2 = $this->createParserOutputStub( 'getTOCHTML', true );
2816 $op->addParserOutput( $pOut2 );
2817 $this->assertTrue( $op->isTOCEnabled() );
2818
2819 // The parser output doesn't disable the TOC after it was enabled
2820 $op->addParserOutputMetadata( $pOut1 );
2821 $this->assertTrue( $op->isTOCEnabled() );
2822 }
2823
2824 /**
2825 * @dataProvider providePreloadLinkHeaders
2826 * @covers ResourceLoaderSkinModule::getPreloadLinks
2827 * @covers ResourceLoaderSkinModule::getLogoPreloadlinks
2828 */
2829 public function testPreloadLinkHeaders( $config, $result ) {
2830 $this->setMwGlobals( $config );
2831 $ctx = $this->getMockBuilder( ResourceLoaderContext::class )
2832 ->disableOriginalConstructor()->getMock();
2833 $module = new ResourceLoaderSkinModule();
2834
2835 $this->assertEquals( [ $result ], $module->getHeaders( $ctx ) );
2836 }
2837
2838 public function providePreloadLinkHeaders() {
2839 return [
2840 [
2841 [
2842 'wgResourceBasePath' => '/w',
2843 'wgLogo' => '/img/default.png',
2844 'wgLogoHD' => [
2845 '1.5x' => '/img/one-point-five.png',
2846 '2x' => '/img/two-x.png',
2847 ],
2848 ],
2849 'Link: </img/default.png>;rel=preload;as=image;media=' .
2850 'not all and (min-resolution: 1.5dppx),' .
2851 '</img/one-point-five.png>;rel=preload;as=image;media=' .
2852 '(min-resolution: 1.5dppx) and (max-resolution: 1.999999dppx),' .
2853 '</img/two-x.png>;rel=preload;as=image;media=(min-resolution: 2dppx)'
2854 ],
2855 [
2856 [
2857 'wgResourceBasePath' => '/w',
2858 'wgLogo' => '/img/default.png',
2859 'wgLogoHD' => false,
2860 ],
2861 'Link: </img/default.png>;rel=preload;as=image'
2862 ],
2863 [
2864 [
2865 'wgResourceBasePath' => '/w',
2866 'wgLogo' => '/img/default.png',
2867 'wgLogoHD' => [
2868 '2x' => '/img/two-x.png',
2869 ],
2870 ],
2871 'Link: </img/default.png>;rel=preload;as=image;media=' .
2872 'not all and (min-resolution: 2dppx),' .
2873 '</img/two-x.png>;rel=preload;as=image;media=(min-resolution: 2dppx)'
2874 ],
2875 [
2876 [
2877 'wgResourceBasePath' => '/w',
2878 'wgLogo' => '/img/default.png',
2879 'wgLogoHD' => [
2880 'svg' => '/img/vector.svg',
2881 ],
2882 ],
2883 'Link: </img/vector.svg>;rel=preload;as=image'
2884
2885 ],
2886 [
2887 [
2888 'wgResourceBasePath' => '/w',
2889 'wgLogo' => '/w/test.jpg',
2890 'wgLogoHD' => false,
2891 'wgUploadPath' => '/w/images',
2892 'IP' => dirname( __DIR__ ) . '/data/media',
2893 ],
2894 'Link: </w/test.jpg?edcf2>;rel=preload;as=image',
2895 ],
2896 ];
2897 }
2898
2899 /**
2900 * @return OutputPage
2901 */
2902 private function newInstance( $config = [], WebRequest $request = null, $options = [] ) {
2903 $context = new RequestContext();
2904
2905 $context->setConfig( new MultiConfig( [
2906 new HashConfig( $config + [
2907 'AppleTouchIcon' => false,
2908 'DisableLangConversion' => true,
2909 'EnableCanonicalServerLink' => false,
2910 'Favicon' => false,
2911 'Feed' => false,
2912 'LanguageCode' => false,
2913 'ReferrerPolicy' => false,
2914 'RightsPage' => false,
2915 'RightsUrl' => false,
2916 'UniversalEditButton' => false,
2917 ] ),
2918 $context->getConfig()
2919 ] ) );
2920
2921 if ( !in_array( 'notitle', (array)$options ) ) {
2922 $context->setTitle( Title::newFromText( 'My test page' ) );
2923 }
2924
2925 if ( $request ) {
2926 $context->setRequest( $request );
2927 }
2928
2929 return new OutputPage( $context );
2930 }
2931 }
2932
2933 /**
2934 * MessageBlobStore that doesn't do anything
2935 */
2936 class NullMessageBlobStore extends MessageBlobStore {
2937 public function get( ResourceLoader $resourceLoader, $modules, $lang ) {
2938 return [];
2939 }
2940
2941 public function updateModule( $name, ResourceLoaderModule $module, $lang ) {
2942 }
2943
2944 public function updateMessage( $key ) {
2945 }
2946
2947 public function clear() {
2948 }
2949 }
Wiklou, le Wiki du Wiklou