tests/phpunit/includes/resourceloader/ResourceLoaderModuleTest.php

   1 <?php
   2
   3 class ResourceLoaderModuleTest extends ResourceLoaderTestCase {
   4
   5         /**
   6          * @covers ResourceLoaderModule::getVersionHash
   7          */
   8         public function testGetVersionHash() {
   9                 $context = $this->getResourceLoaderContext();
  10
  11                 $baseParams = [
  12                         'scripts' => [ 'foo.js', 'bar.js' ],
  13                         'dependencies' => [ 'jquery', 'mediawiki' ],
  14                         'messages' => [ 'hello', 'world' ],
  15                 ];
  16
  17                 $module = new ResourceLoaderFileModule( $baseParams );
  18                 $version = json_encode( $module->getVersionHash( $context ) );
  19
  20                 // Exactly the same
  21                 $module = new ResourceLoaderFileModule( $baseParams );
  22                 $this->assertEquals(
  23                         $version,
  24                         json_encode( $module->getVersionHash( $context ) ),
  25                         'Instance is insignificant'
  26                 );
  27
  28                 // Re-order dependencies
  29                 $module = new ResourceLoaderFileModule( [
  30                         'dependencies' => [ 'mediawiki', 'jquery' ],
  31                 ] + $baseParams );
  32                 $this->assertEquals(
  33                         $version,
  34                         json_encode( $module->getVersionHash( $context ) ),
  35                         'Order of dependencies is insignificant'
  36                 );
  37
  38                 // Re-order messages
  39                 $module = new ResourceLoaderFileModule( [
  40                         'messages' => [ 'world', 'hello' ],
  41                 ] + $baseParams );
  42                 $this->assertEquals(
  43                         $version,
  44                         json_encode( $module->getVersionHash( $context ) ),
  45                         'Order of messages is insignificant'
  46                 );
  47
  48                 // Re-order scripts
  49                 $module = new ResourceLoaderFileModule( [
  50                         'scripts' => [ 'bar.js', 'foo.js' ],
  51                 ] + $baseParams );
  52                 $this->assertNotEquals(
  53                         $version,
  54                         json_encode( $module->getVersionHash( $context ) ),
  55                         'Order of scripts is significant'
  56                 );
  57
  58                 // Subclass
  59                 $module = new ResourceLoaderFileModuleTestModule( $baseParams );
  60                 $this->assertNotEquals(
  61                         $version,
  62                         json_encode( $module->getVersionHash( $context ) ),
  63                         'Class is significant'
  64                 );
  65         }
  66
  67         /**
  68          * @covers ResourceLoaderModule::validateScriptFile
  69          */
  70         public function testValidateScriptFile() {
  71                 $this->setMwGlobals( 'wgResourceLoaderValidateJS', true );
  72
  73                 $context = $this->getResourceLoaderContext();
  74
  75                 $module = new ResourceLoaderTestModule( [
  76                         'script' => "var a = 'this is';\n {\ninvalid"
  77                 ] );
  78                 $this->assertEquals(
  79                         'mw.log.error(' .
  80                                 '"JavaScript parse error: Parse error: Unexpected token; ' .
  81                                 'token } expected in file \'input\' on line 3"' .
  82                         ');',
  83                         $module->getScript( $context ),
  84                         'Replace invalid syntax with error logging'
  85                 );
  86
  87                 $module = new ResourceLoaderTestModule( [
  88                         'script' => "\n'valid';"
  89                 ] );
  90                 $this->assertEquals(
  91                         "\n'valid';",
  92                         $module->getScript( $context ),
  93                         'Leave valid scripts as-is'
  94                 );
  95         }
  96
  97         public static function provideBuildContentScripts() {
  98                 return [
  99                         [
 100                                 "mw.foo()",
 101                                 "mw.foo();\n",
 102                         ],
 103                         [
 104                                 "mw.foo();",
 105                                 "mw.foo();",
 106                         ],
 107                         [
 108                                 "mw.foo();\n",
 109                                 "mw.foo();\n",
 110                         ],
 111                         [
 112                                 "mw.foo()\n",
 113                                 "mw.foo()\n;\n",
 114                         ],
 115                         [
 116                                 "mw.foo()\n// mw.bar();",
 117                                 "mw.foo()\n// mw.bar();",
 118                         ],
 119                         [
 120                                 "mw.foo()// mw.bar();",
 121                                 "mw.foo()// mw.bar();",
 122                         ],
 123                 ];
 124         }
 125
 126         /**
 127          * @dataProvider provideBuildContentScripts
 128          * @covers ResourceLoaderModule::buildContent
 129          */
 130         public function testBuildContentScripts( $raw, $build, $message = null ) {
 131                 $context = $this->getResourceLoaderContext();
 132                 $module = new ResourceLoaderTestModule( [
 133                         'script' => $raw
 134                 ] );
 135                 $this->assertEquals( $raw, $module->getScript( $context ), 'Raw script' );
 136                 $this->assertEquals(
 137                         [ 'scripts' => $build ],
 138                         $module->getModuleContent( $context ),
 139                         $message
 140                 );
 141         }
 142
 143         /**
 144          * @covers ResourceLoaderModule::getRelativePaths
 145          * @covers ResourceLoaderModule::expandRelativePaths
 146          */
 147         public function testPlaceholderize() {
 148                 $getRelativePaths = new ReflectionMethod( 'ResourceLoaderModule', 'getRelativePaths' );
 149                 $getRelativePaths->setAccessible( true );
 150                 $expandRelativePaths = new ReflectionMethod( 'ResourceLoaderModule', 'expandRelativePaths' );
 151                 $expandRelativePaths->setAccessible( true );
 152
 153                 $this->setMwGlobals( [
 154                         'IP' => '/srv/example/mediawiki/core',
 155                 ] );
 156                 $raw = [
 157                                 '/srv/example/mediawiki/core/resources/foo.js',
 158                                 '/srv/example/mediawiki/core/extensions/Example/modules/bar.js',
 159                                 '/srv/example/mediawiki/skins/Example/baz.css',
 160                                 '/srv/example/mediawiki/skins/Example/images/quux.png',
 161                 ];
 162                 $canonical = [
 163                                 'resources/foo.js',
 164                                 'extensions/Example/modules/bar.js',
 165                                 '../skins/Example/baz.css',
 166                                 '../skins/Example/images/quux.png',
 167                 ];
 168                 $this->assertEquals(
 169                         $canonical,
 170                         $getRelativePaths->invoke( null, $raw ),
 171                         'Insert placeholders'
 172                 );
 173                 $this->assertEquals(
 174                         $raw,
 175                         $expandRelativePaths->invoke( null, $canonical ),
 176                         'Substitute placeholders'
 177                 );
 178         }
 179 }