tests/phpunit/includes/resourceloader/DerivativeResourceLoaderContextTest.php

   1 <?php
   2
   3 /**
   4  * @group ResourceLoader
   5  * @covers DerivativeResourceLoaderContext
   6  */
   7 class DerivativeResourceLoaderContextTest extends PHPUnit\Framework\TestCase {
   8
   9         use MediaWikiCoversValidator;
  10
  11         protected static function makeContext() {
  12                 $request = new FauxRequest( [
  13                                 'lang' => 'qqx',
  14                                 'modules' => 'test.default',
  15                                 'only' => 'scripts',
  16                                 'skin' => 'fallback',
  17                                 'target' => 'test',
  18                 ] );
  19                 return new ResourceLoaderContext( new ResourceLoader(), $request );
  20         }
  21
  22         public function testChangeModules() {
  23                 $derived = new DerivativeResourceLoaderContext( self::makeContext() );
  24                 $this->assertSame( $derived->getModules(), [ 'test.default' ], 'inherit from parent' );
  25
  26                 $derived->setModules( [ 'test.override' ] );
  27                 $this->assertSame( $derived->getModules(), [ 'test.override' ] );
  28         }
  29
  30         public function testChangeLanguageAndDirection() {
  31                 $derived = new DerivativeResourceLoaderContext( self::makeContext() );
  32                 $this->assertSame( $derived->getLanguage(), 'qqx', 'inherit from parent' );
  33                 $this->assertSame( $derived->getDirection(), 'ltr', 'inherit from parent' );
  34
  35                 $derived->setLanguage( 'nl' );
  36                 $this->assertSame( $derived->getLanguage(), 'nl' );
  37                 $this->assertSame( $derived->getDirection(), 'ltr' );
  38
  39                 // Changing the language must clear cache of computed direction
  40                 $derived->setLanguage( 'he' );
  41                 $this->assertSame( $derived->getDirection(), 'rtl' );
  42                 $this->assertSame( $derived->getLanguage(), 'he' );
  43
  44                 // Overriding the direction explicitly is allowed
  45                 $derived->setDirection( 'ltr' );
  46                 $this->assertSame( $derived->getDirection(), 'ltr' );
  47                 $this->assertSame( $derived->getLanguage(), 'he' );
  48         }
  49
  50         public function testChangeSkin() {
  51                 $derived = new DerivativeResourceLoaderContext( self::makeContext() );
  52                 $this->assertSame( $derived->getSkin(), 'fallback', 'inherit from parent' );
  53
  54                 $derived->setSkin( 'myskin' );
  55                 $this->assertSame( $derived->getSkin(), 'myskin' );
  56         }
  57
  58         public function testChangeUser() {
  59                 $derived = new DerivativeResourceLoaderContext( self::makeContext() );
  60                 $this->assertSame( $derived->getUser(), null, 'inherit from parent' );
  61
  62                 $derived->setUser( 'MyUser' );
  63                 $this->assertSame( $derived->getUser(), 'MyUser' );
  64         }
  65
  66         public function testChangeDebug() {
  67                 $derived = new DerivativeResourceLoaderContext( self::makeContext() );
  68                 $this->assertSame( $derived->getDebug(), false, 'inherit from parent' );
  69
  70                 $derived->setDebug( true );
  71                 $this->assertSame( $derived->getDebug(), true );
  72         }
  73
  74         public function testChangeOnly() {
  75                 $derived = new DerivativeResourceLoaderContext( self::makeContext() );
  76                 $this->assertSame( $derived->getOnly(), 'scripts', 'inherit from parent' );
  77
  78                 $derived->setOnly( 'styles' );
  79                 $this->assertSame( $derived->getOnly(), 'styles' );
  80
  81                 $derived->setOnly( null );
  82                 $this->assertSame( $derived->getOnly(), null );
  83         }
  84
  85         public function testChangeVersion() {
  86                 $derived = new DerivativeResourceLoaderContext( self::makeContext() );
  87                 $this->assertSame( $derived->getVersion(), null );
  88
  89                 $derived->setVersion( 'hw1' );
  90                 $this->assertSame( $derived->getVersion(), 'hw1' );
  91         }
  92
  93         public function testChangeRaw() {
  94                 $derived = new DerivativeResourceLoaderContext( self::makeContext() );
  95                 $this->assertSame( $derived->getRaw(), false, 'inherit from parent' );
  96
  97                 $derived->setRaw( true );
  98                 $this->assertSame( $derived->getRaw(), true );
  99         }
 100
 101         public function testChangeHash() {
 102                 $derived = new DerivativeResourceLoaderContext( self::makeContext() );
 103                 $this->assertSame( $derived->getHash(), 'qqx|fallback|||scripts|||||', 'inherit' );
 104
 105                 $derived->setLanguage( 'nl' );
 106                 $derived->setUser( 'Example' );
 107                 // Assert that subclass is able to clear parent class "hash" member
 108                 $this->assertSame( $derived->getHash(), 'nl|fallback||Example|scripts|||||' );
 109         }
 110
 111         public function testChangeContentOverrides() {
 112                 $derived = new DerivativeResourceLoaderContext( self::makeContext() );
 113                 $this->assertNull( $derived->getContentOverrideCallback(), 'default' );
 114
 115                 $override = function ( Title $t ) {
 116                         return null;
 117                 };
 118                 $derived->setContentOverrideCallback( $override );
 119                 $this->assertSame( $override, $derived->getContentOverrideCallback(), 'changed' );
 120
 121                 $derived2 = new DerivativeResourceLoaderContext( $derived );
 122                 $this->assertSame(
 123                         $override,
 124                         $derived2->getContentOverrideCallback(),
 125                         'change via a second derivative layer'
 126                 );
 127         }
 128
 129         public function testImmutableAccessors() {
 130                 $context = self::makeContext();
 131                 $derived = new DerivativeResourceLoaderContext( $context );
 132                 $this->assertSame( $derived->getRequest(), $context->getRequest() );
 133                 $this->assertSame( $derived->getResourceLoader(), $context->getResourceLoader() );
 134         }
 135 }