maintenance/tests/phpunit/includes/ResourceLoaderTest.php

   1 <?php
   2
   3 class ResourceLoaderTest extends PHPUnit_Framework_TestCase {
   4
   5         protected static $resourceLoaderRegisterModulesHook;
   6
   7         /* Hook Methods */
   8
   9         /**
  10          * ResourceLoaderRegisterModules hook
  11          */
  12         public static function resourceLoaderRegisterModules( &$resourceLoader ) {
  13                 self::$resourceLoaderRegisterModulesHook = true;
  14                 return true;
  15         }
  16
  17         /* Provider Methods */
  18         public function provideValidModules() {
  19                 return array(
  20                         array( 'TEST.validModule1', new ResourceLoaderTestModule() ),
  21                 );
  22         }
  23
  24         /* Test Methods */
  25
  26         /**
  27          * Ensures that the ResourceLoaderRegisterModules hook is called when a new ResourceLoader object is constructed
  28          * @covers ResourceLoader::__construct
  29          */
  30         public function testCreatingNewResourceLoaderCallsRegistrationHook() {
  31                 self::$resourceLoaderRegisterModulesHook = false;
  32                 $resourceLoader = new ResourceLoader();
  33                 $this->assertTrue( self::$resourceLoaderRegisterModulesHook );
  34                 return $resourceLoader;
  35         }
  36
  37         /**
  38          * @dataProvider provideValidModules
  39          * @depends testCreatingNewResourceLoaderCallsRegistrationHook
  40          * @covers ResourceLoader::register
  41          * @covers ResourceLoader::getModule
  42          */
  43         public function testRegisteredValidModulesAreAccessible(
  44                 $name, ResourceLoaderModule $module, ResourceLoader $resourceLoader
  45         ) {
  46                 $resourceLoader->register( $name, $module );
  47                 $this->assertEquals( $module, $resourceLoader->getModule( $name ) );
  48         }
  49
  50         /**
  51          * Allthough ResourceLoader::register uses type hinting to prevent arbitrary information being passed through as a
  52          * ResourceLoaderModule object, null can still get through.
  53          *
  54          * @depends testCreatingNewResourceLoaderCallsRegistrationHook
  55          * @covers ResourceLoader::register
  56          * @covers ResourceLoader::getModule
  57          * @expectedException MWException
  58          */
  59         public function testRegisteringNullModuleThrowsAnException( ResourceLoader $resourceLoader ) {
  60                 $this->markTestIncomplete( "Broken by r77011" );
  61                 $resourceLoader->register( 'TEST.nullModule', null );
  62         }
  63 }
  64
  65 /* Stubs */
  66
  67 class ResourceLoaderTestModule extends ResourceLoaderModule { }
  68
  69 /* Hooks */
  70 global $wgHooks;
  71 $wgHooks['ResourceLoaderRegisterModules'][] = 'ResourceLoaderTest::resourceLoaderRegisterModules';