tests/phpunit/includes/content/ContentHandlerTest.php

   1 <?php
   2 use MediaWiki\MediaWikiServices;
   3
   4 /**
   5  * @group ContentHandler
   6  * @group Database
   7  */
   8 class ContentHandlerTest extends MediaWikiTestCase {
   9
  10         protected function setUp() {
  11                 global $wgContLang;
  12                 parent::setUp();
  13
  14                 $this->setMwGlobals( [
  15                         'wgExtraNamespaces' => [
  16                                 12312 => 'Dummy',
  17                                 12313 => 'Dummy_talk',
  18                         ],
  19                         // The below tests assume that namespaces not mentioned here (Help, User, MediaWiki, ..)
  20                         // default to CONTENT_MODEL_WIKITEXT.
  21                         'wgNamespaceContentModels' => [
  22                                 12312 => 'testing',
  23                         ],
  24                         'wgContentHandlers' => [
  25                                 CONTENT_MODEL_WIKITEXT => WikitextContentHandler::class,
  26                                 CONTENT_MODEL_JAVASCRIPT => JavaScriptContentHandler::class,
  27                                 CONTENT_MODEL_JSON => JsonContentHandler::class,
  28                                 CONTENT_MODEL_CSS => CssContentHandler::class,
  29                                 CONTENT_MODEL_TEXT => TextContentHandler::class,
  30                                 'testing' => DummyContentHandlerForTesting::class,
  31                                 'testing-callbacks' => function ( $modelId ) {
  32                                         return new DummyContentHandlerForTesting( $modelId );
  33                                 }
  34                         ],
  35                 ] );
  36
  37                 // Reset namespace cache
  38                 MWNamespace::clearCaches();
  39                 $wgContLang->resetNamespaces();
  40                 // And LinkCache
  41                 MediaWikiServices::getInstance()->resetServiceForTesting( 'LinkCache' );
  42         }
  43
  44         protected function tearDown() {
  45                 global $wgContLang;
  46
  47                 // Reset namespace cache
  48                 MWNamespace::clearCaches();
  49                 $wgContLang->resetNamespaces();
  50                 // And LinkCache
  51                 MediaWikiServices::getInstance()->resetServiceForTesting( 'LinkCache' );
  52
  53                 parent::tearDown();
  54         }
  55
  56         public function addDBDataOnce() {
  57                 $this->insertPage( 'Not_Main_Page', 'This is not a main page' );
  58                 $this->insertPage( 'Smithee', 'A smithee is one who smiths. See also [[Alan Smithee]]' );
  59         }
  60
  61         public static function dataGetDefaultModelFor() {
  62                 return [
  63                         [ 'Help:Foo', CONTENT_MODEL_WIKITEXT ],
  64                         [ 'Help:Foo.js', CONTENT_MODEL_WIKITEXT ],
  65                         [ 'Help:Foo.css', CONTENT_MODEL_WIKITEXT ],
  66                         [ 'Help:Foo.json', CONTENT_MODEL_WIKITEXT ],
  67                         [ 'Help:Foo/bar.js', CONTENT_MODEL_WIKITEXT ],
  68                         [ 'User:Foo', CONTENT_MODEL_WIKITEXT ],
  69                         [ 'User:Foo.js', CONTENT_MODEL_WIKITEXT ],
  70                         [ 'User:Foo.css', CONTENT_MODEL_WIKITEXT ],
  71                         [ 'User:Foo.json', CONTENT_MODEL_WIKITEXT ],
  72                         [ 'User:Foo/bar.js', CONTENT_MODEL_JAVASCRIPT ],
  73                         [ 'User:Foo/bar.css', CONTENT_MODEL_CSS ],
  74                         [ 'User:Foo/bar.json', CONTENT_MODEL_JSON ],
  75                         [ 'User:Foo/bar.json.nope', CONTENT_MODEL_WIKITEXT ],
  76                         [ 'User talk:Foo/bar.css', CONTENT_MODEL_WIKITEXT ],
  77                         [ 'User:Foo/bar.js.xxx', CONTENT_MODEL_WIKITEXT ],
  78                         [ 'User:Foo/bar.xxx', CONTENT_MODEL_WIKITEXT ],
  79                         [ 'MediaWiki:Foo.js', CONTENT_MODEL_JAVASCRIPT ],
  80                         [ 'MediaWiki:Foo.JS', CONTENT_MODEL_WIKITEXT ],
  81                         [ 'MediaWiki:Foo.css', CONTENT_MODEL_CSS ],
  82                         [ 'MediaWiki:Foo.css.xxx', CONTENT_MODEL_WIKITEXT ],
  83                         [ 'MediaWiki:Foo.CSS', CONTENT_MODEL_WIKITEXT ],
  84                         [ 'MediaWiki:Foo.json', CONTENT_MODEL_JSON ],
  85                         [ 'MediaWiki:Foo.JSON', CONTENT_MODEL_WIKITEXT ],
  86                 ];
  87         }
  88
  89         /**
  90          * @dataProvider dataGetDefaultModelFor
  91          * @covers ContentHandler::getDefaultModelFor
  92          */
  93         public function testGetDefaultModelFor( $title, $expectedModelId ) {
  94                 $title = Title::newFromText( $title );
  95                 $this->assertEquals( $expectedModelId, ContentHandler::getDefaultModelFor( $title ) );
  96         }
  97
  98         /**
  99          * @dataProvider dataGetDefaultModelFor
 100          * @covers ContentHandler::getForTitle
 101          */
 102         public function testGetForTitle( $title, $expectedContentModel ) {
 103                 $title = Title::newFromText( $title );
 104                 LinkCache::singleton()->addBadLinkObj( $title );
 105                 $handler = ContentHandler::getForTitle( $title );
 106                 $this->assertEquals( $expectedContentModel, $handler->getModelID() );
 107         }
 108
 109         public static function dataGetLocalizedName() {
 110                 return [
 111                         [ null, null ],
 112                         [ "xyzzy", null ],
 113
 114                         // XXX: depends on content language
 115                         [ CONTENT_MODEL_JAVASCRIPT, '/javascript/i' ],
 116                 ];
 117         }
 118
 119         /**
 120          * @dataProvider dataGetLocalizedName
 121          * @covers ContentHandler::getLocalizedName
 122          */
 123         public function testGetLocalizedName( $id, $expected ) {
 124                 $name = ContentHandler::getLocalizedName( $id );
 125
 126                 if ( $expected ) {
 127                         $this->assertNotNull( $name, "no name found for content model $id" );
 128                         $this->assertTrue( preg_match( $expected, $name ) > 0,
 129                                 "content model name for #$id did not match pattern $expected"
 130                         );
 131                 } else {
 132                         $this->assertEquals( $id, $name, "localization of unknown model $id should have "
 133                                 . "fallen back to use the model id directly."
 134                         );
 135                 }
 136         }
 137
 138         public static function dataGetPageLanguage() {
 139                 global $wgLanguageCode;
 140
 141                 return [
 142                         [ "Main", $wgLanguageCode ],
 143                         [ "Dummy:Foo", $wgLanguageCode ],
 144                         [ "MediaWiki:common.js", 'en' ],
 145                         [ "User:Foo/common.js", 'en' ],
 146                         [ "MediaWiki:common.css", 'en' ],
 147                         [ "User:Foo/common.css", 'en' ],
 148                         [ "User:Foo", $wgLanguageCode ],
 149
 150                         [ CONTENT_MODEL_JAVASCRIPT, 'javascript' ],
 151                 ];
 152         }
 153
 154         /**
 155          * @dataProvider dataGetPageLanguage
 156          * @covers ContentHandler::getPageLanguage
 157          */
 158         public function testGetPageLanguage( $title, $expected ) {
 159                 if ( is_string( $title ) ) {
 160                         $title = Title::newFromText( $title );
 161                         LinkCache::singleton()->addBadLinkObj( $title );
 162                 }
 163
 164                 $expected = wfGetLangObj( $expected );
 165
 166                 $handler = ContentHandler::getForTitle( $title );
 167                 $lang = $handler->getPageLanguage( $title );
 168
 169                 $this->assertEquals( $expected->getCode(), $lang->getCode() );
 170         }
 171
 172         public static function dataGetContentText_Null() {
 173                 return [
 174                         [ 'fail' ],
 175                         [ 'serialize' ],
 176                         [ 'ignore' ],
 177                 ];
 178         }
 179
 180         /**
 181          * @dataProvider dataGetContentText_Null
 182          * @covers ContentHandler::getContentText
 183          */
 184         public function testGetContentText_Null( $contentHandlerTextFallback ) {
 185                 $this->setMwGlobals( 'wgContentHandlerTextFallback', $contentHandlerTextFallback );
 186
 187                 $content = null;
 188
 189                 $text = ContentHandler::getContentText( $content );
 190                 $this->assertEquals( '', $text );
 191         }
 192
 193         public static function dataGetContentText_TextContent() {
 194                 return [
 195                         [ 'fail' ],
 196                         [ 'serialize' ],
 197                         [ 'ignore' ],
 198                 ];
 199         }
 200
 201         /**
 202          * @dataProvider dataGetContentText_TextContent
 203          * @covers ContentHandler::getContentText
 204          */
 205         public function testGetContentText_TextContent( $contentHandlerTextFallback ) {
 206                 $this->setMwGlobals( 'wgContentHandlerTextFallback', $contentHandlerTextFallback );
 207
 208                 $content = new WikitextContent( "hello world" );
 209
 210                 $text = ContentHandler::getContentText( $content );
 211                 $this->assertEquals( $content->getNativeData(), $text );
 212         }
 213
 214         /**
 215          * ContentHandler::getContentText should have thrown an exception for non-text Content object
 216          * @expectedException MWException
 217          * @covers ContentHandler::getContentText
 218          */
 219         public function testGetContentText_NonTextContent_fail() {
 220                 $this->setMwGlobals( 'wgContentHandlerTextFallback', 'fail' );
 221
 222                 $content = new DummyContentForTesting( "hello world" );
 223
 224                 ContentHandler::getContentText( $content );
 225         }
 226
 227         /**
 228          * @covers ContentHandler::getContentText
 229          */
 230         public function testGetContentText_NonTextContent_serialize() {
 231                 $this->setMwGlobals( 'wgContentHandlerTextFallback', 'serialize' );
 232
 233                 $content = new DummyContentForTesting( "hello world" );
 234
 235                 $text = ContentHandler::getContentText( $content );
 236                 $this->assertEquals( $content->serialize(), $text );
 237         }
 238
 239         /**
 240          * @covers ContentHandler::getContentText
 241          */
 242         public function testGetContentText_NonTextContent_ignore() {
 243                 $this->setMwGlobals( 'wgContentHandlerTextFallback', 'ignore' );
 244
 245                 $content = new DummyContentForTesting( "hello world" );
 246
 247                 $text = ContentHandler::getContentText( $content );
 248                 $this->assertNull( $text );
 249         }
 250
 251         public static function dataMakeContent() {
 252                 return [
 253                         [ 'hallo', 'Help:Test', null, null, CONTENT_MODEL_WIKITEXT, 'hallo', false ],
 254                         [ 'hallo', 'MediaWiki:Test.js', null, null, CONTENT_MODEL_JAVASCRIPT, 'hallo', false ],
 255                         [ serialize( 'hallo' ), 'Dummy:Test', null, null, "testing", 'hallo', false ],
 256
 257                         [
 258                                 'hallo',
 259                                 'Help:Test',
 260                                 null,
 261                                 CONTENT_FORMAT_WIKITEXT,
 262                                 CONTENT_MODEL_WIKITEXT,
 263                                 'hallo',
 264                                 false
 265                         ],
 266                         [
 267                                 'hallo',
 268                                 'MediaWiki:Test.js',
 269                                 null,
 270                                 CONTENT_FORMAT_JAVASCRIPT,
 271                                 CONTENT_MODEL_JAVASCRIPT,
 272                                 'hallo',
 273                                 false
 274                         ],
 275                         [ serialize( 'hallo' ), 'Dummy:Test', null, "testing", "testing", 'hallo', false ],
 276
 277                         [ 'hallo', 'Help:Test', CONTENT_MODEL_CSS, null, CONTENT_MODEL_CSS, 'hallo', false ],
 278                         [
 279                                 'hallo',
 280                                 'MediaWiki:Test.js',
 281                                 CONTENT_MODEL_CSS,
 282                                 null,
 283                                 CONTENT_MODEL_CSS,
 284                                 'hallo',
 285                                 false
 286                         ],
 287                         [
 288                                 serialize( 'hallo' ),
 289                                 'Dummy:Test',
 290                                 CONTENT_MODEL_CSS,
 291                                 null,
 292                                 CONTENT_MODEL_CSS,
 293                                 serialize( 'hallo' ),
 294                                 false
 295                         ],
 296
 297                         [ 'hallo', 'Help:Test', CONTENT_MODEL_WIKITEXT, "testing", null, null, true ],
 298                         [ 'hallo', 'MediaWiki:Test.js', CONTENT_MODEL_CSS, "testing", null, null, true ],
 299                         [ 'hallo', 'Dummy:Test', CONTENT_MODEL_JAVASCRIPT, "testing", null, null, true ],
 300                 ];
 301         }
 302
 303         /**
 304          * @dataProvider dataMakeContent
 305          * @covers ContentHandler::makeContent
 306          */
 307         public function testMakeContent( $data, $title, $modelId, $format,
 308                 $expectedModelId, $expectedNativeData, $shouldFail
 309         ) {
 310                 $title = Title::newFromText( $title );
 311                 LinkCache::singleton()->addBadLinkObj( $title );
 312                 try {
 313                         $content = ContentHandler::makeContent( $data, $title, $modelId, $format );
 314
 315                         if ( $shouldFail ) {
 316                                 $this->fail( "ContentHandler::makeContent should have failed!" );
 317                         }
 318
 319                         $this->assertEquals( $expectedModelId, $content->getModel(), 'bad model id' );
 320                         $this->assertEquals( $expectedNativeData, $content->getNativeData(), 'bads native data' );
 321                 } catch ( MWException $ex ) {
 322                         if ( !$shouldFail ) {
 323                                 $this->fail( "ContentHandler::makeContent failed unexpectedly: " . $ex->getMessage() );
 324                         } else {
 325                                 // dummy, so we don't get the "test did not perform any assertions" message.
 326                                 $this->assertTrue( true );
 327                         }
 328                 }
 329         }
 330
 331         /**
 332          * @covers ContentHandler::getAutosummary
 333          *
 334          * Test if we become a "Created blank page" summary from getAutoSummary if no Content added to
 335          * page.
 336          */
 337         public function testGetAutosummary() {
 338                 $this->setMwGlobals( 'wgContLang', Language::factory( 'en' ) );
 339
 340                 $content = new DummyContentHandlerForTesting( CONTENT_MODEL_WIKITEXT );
 341                 $title = Title::newFromText( 'Help:Test' );
 342                 // Create a new content object with no content
 343                 $newContent = ContentHandler::makeContent( '', $title, CONTENT_MODEL_WIKITEXT, null );
 344                 // first check, if we become a blank page created summary with the right bitmask
 345                 $autoSummary = $content->getAutosummary( null, $newContent, 97 );
 346                 $this->assertEquals( $autoSummary,
 347                         wfMessage( 'autosumm-newblank' )->inContentLanguage()->text() );
 348                 // now check, what we become with another bitmask
 349                 $autoSummary = $content->getAutosummary( null, $newContent, 92 );
 350                 $this->assertEquals( $autoSummary, '' );
 351         }
 352
 353         /**
 354          * Test software tag that is added when content model of the page changes
 355          * @covers ContentHandler::getChangeTag
 356          */
 357         public function testGetChangeTag() {
 358                 $this->setMwGlobals( 'wgSoftwareTags', [ 'mw-contentmodelchange' => true ] );
 359                 $wikitextContentHandler = new DummyContentHandlerForTesting( CONTENT_MODEL_WIKITEXT );
 360                 // Create old content object with javascript content model
 361                 $oldContent = ContentHandler::makeContent( '', null, CONTENT_MODEL_JAVASCRIPT, null );
 362                 // Create new content object with wikitext content model
 363                 $newContent = ContentHandler::makeContent( '', null, CONTENT_MODEL_WIKITEXT, null );
 364                 // Get the tag for this edit
 365                 $tag = $wikitextContentHandler->getChangeTag( $oldContent, $newContent, EDIT_UPDATE );
 366                 $this->assertSame( $tag, 'mw-contentmodelchange' );
 367         }
 368
 369         /**
 370          * @covers ContentHandler::supportsCategories
 371          */
 372         public function testSupportsCategories() {
 373                 $handler = new DummyContentHandlerForTesting( CONTENT_MODEL_WIKITEXT );
 374                 $this->assertTrue( $handler->supportsCategories(), 'content model supports categories' );
 375         }
 376
 377         /**
 378          * @covers ContentHandler::supportsDirectEditing
 379          */
 380         public function testSupportsDirectEditing() {
 381                 $handler = new DummyContentHandlerForTesting( CONTENT_MODEL_JSON );
 382                 $this->assertFalse( $handler->supportsDirectEditing(), 'direct editing is not supported' );
 383         }
 384
 385         public static function dummyHookHandler( $foo, &$text, $bar ) {
 386                 if ( $text === null || $text === false ) {
 387                         return false;
 388                 }
 389
 390                 $text = strtoupper( $text );
 391
 392                 return true;
 393         }
 394
 395         public function provideGetModelForID() {
 396                 return [
 397                         [ CONTENT_MODEL_WIKITEXT, WikitextContentHandler::class ],
 398                         [ CONTENT_MODEL_JAVASCRIPT, JavaScriptContentHandler::class ],
 399                         [ CONTENT_MODEL_JSON, JsonContentHandler::class ],
 400                         [ CONTENT_MODEL_CSS, CssContentHandler::class ],
 401                         [ CONTENT_MODEL_TEXT, TextContentHandler::class ],
 402                         [ 'testing', DummyContentHandlerForTesting::class ],
 403                         [ 'testing-callbacks', DummyContentHandlerForTesting::class ],
 404                 ];
 405         }
 406
 407         /**
 408          * @covers ContentHandler::getForModelID
 409          * @dataProvider provideGetModelForID
 410          */
 411         public function testGetModelForID( $modelId, $handlerClass ) {
 412                 $handler = ContentHandler::getForModelID( $modelId );
 413
 414                 $this->assertInstanceOf( $handlerClass, $handler );
 415         }
 416
 417         /**
 418          * @covers ContentHandler::getFieldsForSearchIndex
 419          */
 420         public function testGetFieldsForSearchIndex() {
 421                 $searchEngine = $this->newSearchEngine();
 422
 423                 $handler = ContentHandler::getForModelID( CONTENT_MODEL_WIKITEXT );
 424
 425                 $fields = $handler->getFieldsForSearchIndex( $searchEngine );
 426
 427                 $this->assertArrayHasKey( 'category', $fields );
 428                 $this->assertArrayHasKey( 'external_link', $fields );
 429                 $this->assertArrayHasKey( 'outgoing_link', $fields );
 430                 $this->assertArrayHasKey( 'template', $fields );
 431                 $this->assertArrayHasKey( 'content_model', $fields );
 432         }
 433
 434         private function newSearchEngine() {
 435                 $searchEngine = $this->getMockBuilder( SearchEngine::class )
 436                         ->getMock();
 437
 438                 $searchEngine->expects( $this->any() )
 439                         ->method( 'makeSearchFieldMapping' )
 440                         ->will( $this->returnCallback( function ( $name, $type ) {
 441                                         return new DummySearchIndexFieldDefinition( $name, $type );
 442                         } ) );
 443
 444                 return $searchEngine;
 445         }
 446
 447         /**
 448          * @covers ContentHandler::getDataForSearchIndex
 449          */
 450         public function testDataIndexFields() {
 451                 $mockEngine = $this->createMock( SearchEngine::class );
 452                 $title = Title::newFromText( 'Not_Main_Page', NS_MAIN );
 453                 $page = new WikiPage( $title );
 454
 455                 $this->setTemporaryHook( 'SearchDataForIndex',
 456                         function (
 457                                 &$fields,
 458                                 ContentHandler $handler,
 459                                 WikiPage $page,
 460                                 ParserOutput $output,
 461                                 SearchEngine $engine
 462                         ) {
 463                                 $fields['testDataField'] = 'test content';
 464                         } );
 465
 466                 $output = $page->getContent()->getParserOutput( $title );
 467                 $data = $page->getContentHandler()->getDataForSearchIndex( $page, $output, $mockEngine );
 468                 $this->assertArrayHasKey( 'text', $data );
 469                 $this->assertArrayHasKey( 'text_bytes', $data );
 470                 $this->assertArrayHasKey( 'language', $data );
 471                 $this->assertArrayHasKey( 'testDataField', $data );
 472                 $this->assertEquals( 'test content', $data['testDataField'] );
 473                 $this->assertEquals( 'wikitext', $data['content_model'] );
 474         }
 475
 476         /**
 477          * @covers ContentHandler::getParserOutputForIndexing
 478          */
 479         public function testParserOutputForIndexing() {
 480                 $title = Title::newFromText( 'Smithee', NS_MAIN );
 481                 $page = new WikiPage( $title );
 482
 483                 $out = $page->getContentHandler()->getParserOutputForIndexing( $page );
 484                 $this->assertInstanceOf( ParserOutput::class, $out );
 485                 $this->assertContains( 'one who smiths', $out->getRawText() );
 486         }
 487
 488         /**
 489          * @covers ContentHandler::getContentModels
 490          */
 491         public function testGetContentModelsHook() {
 492                 $this->setTemporaryHook( 'GetContentModels', function ( &$models ) {
 493                         $models[] = 'Ferrari';
 494                 } );
 495                 $this->assertContains( 'Ferrari', ContentHandler::getContentModels() );
 496         }
 497 }