3 use Wikimedia\TestingAccessWrapper
;
4 use MediaWiki\MediaWikiServices
;
6 class ResourceLoaderTest
extends ResourceLoaderTestCase
{
8 protected function setUp() {
11 $this->setMwGlobals( [
12 'wgShowExceptionDetails' => true,
17 * Ensure the ResourceLoaderRegisterModules hook is called.
20 public function testServiceWiring() {
22 $this->setMwGlobals( 'wgHooks', [
23 'ResourceLoaderRegisterModules' => [
24 function ( &$resourceLoader ) use ( &$ranHook ) {
30 MediaWikiServices
::getInstance()->getResourceLoader();
32 $this->assertSame( 1, $ranHook, 'Hook was called' );
35 public static function provideInvalidModuleName() {
37 'name with 300 chars' => [ str_repeat( 'x', 300 ) ],
38 'name with bang' => [ 'this!that' ],
39 'name with comma' => [ 'this,that' ],
40 'name with pipe' => [ 'this|that' ],
44 public static function provideValidModuleName() {
46 'empty string' => [ '' ],
47 'simple name' => [ 'this.and-that2' ],
48 'name with 100 chars' => [ str_repeat( 'x', 100 ) ],
49 'name with hash' => [ 'this#that' ],
50 'name with slash' => [ 'this/that' ],
51 'name with at' => [ 'this@that' ],
56 * @dataProvider provideInvalidModuleName
57 * @covers ResourceLoader
59 public function testIsValidModuleName_invalid( $name ) {
60 $this->assertFalse( ResourceLoader
::isValidModuleName( $name ) );
64 * @dataProvider provideValidModuleName
65 * @covers ResourceLoader
67 public function testIsValidModuleName_valid( $name ) {
68 $this->assertTrue( ResourceLoader
::isValidModuleName( $name ) );
72 * @covers ResourceLoader::register
73 * @covers ResourceLoader::getModule
75 public function testRegisterValidArray() {
76 $resourceLoader = new EmptyResourceLoader();
77 // Covers case of register() setting $rl->moduleInfos,
78 // but $rl->modules lazy-populated by getModule()
79 $resourceLoader->register( 'test', [ 'class' => ResourceLoaderTestModule
::class ] );
80 $this->assertInstanceOf(
81 ResourceLoaderTestModule
::class,
82 $resourceLoader->getModule( 'test' )
87 * @covers ResourceLoader::register
90 public function testRegisterEmptyString() {
91 $resourceLoader = new EmptyResourceLoader();
92 $resourceLoader->register( '', [ 'class' => ResourceLoaderTestModule
::class ] );
93 $this->assertInstanceOf(
94 ResourceLoaderTestModule
::class,
95 $resourceLoader->getModule( '' )
100 * @covers ResourceLoader::register
103 public function testRegisterInvalidName() {
104 $resourceLoader = new EmptyResourceLoader();
105 $this->setExpectedException( MWException
::class, "name 'test!invalid' is invalid" );
106 $resourceLoader->register( 'test!invalid', [] );
110 * @covers ResourceLoader::register
112 public function testRegisterInvalidType() {
113 $resourceLoader = new EmptyResourceLoader();
114 $this->setExpectedException( InvalidArgumentException
::class, 'Invalid module info' );
115 $resourceLoader->register( 'test', new stdClass() );
119 * @covers ResourceLoader::register
121 public function testRegisterDuplicate() {
122 $logger = $this->getMockBuilder( Psr\Log\LoggerInterface
::class )->getMock();
123 $logger->expects( $this->once() )
124 ->method( 'warning' );
125 $resourceLoader = new EmptyResourceLoader( null, $logger );
127 $resourceLoader->register( 'test', [ 'class' => ResourceLoaderSkinModule
::class ] );
128 $resourceLoader->register( 'test', [ 'class' => ResourceLoaderStartUpModule
::class ] );
129 $this->assertInstanceOf(
130 ResourceLoaderStartUpModule
::class,
131 $resourceLoader->getModule( 'test' ),
137 * @covers ResourceLoader::getModuleNames
139 public function testGetModuleNames() {
140 // Use an empty one so that core and extension modules don't get in.
141 $resourceLoader = new EmptyResourceLoader();
142 $resourceLoader->register( 'test.foo', [] );
143 $resourceLoader->register( 'test.bar', [] );
145 [ 'startup', 'test.foo', 'test.bar' ],
146 $resourceLoader->getModuleNames()
150 public function provideTestIsFileModule() {
151 $fileModuleObj = $this->createMock( ResourceLoaderFileModule
::class );
153 'factory ignored' => [ false,
155 'factory' => function () {
156 return new ResourceLoaderTestModule();
160 'factory ignored (actual FileModule)' => [ false,
162 'factory' => function () use ( $fileModuleObj ) {
163 return $fileModuleObj;
167 'simple empty' => [ true,
170 'simple scripts' => [ true,
171 [ 'scripts' => 'example.js' ]
173 'simple scripts with targets' => [ true, [
174 'scripts' => [ 'a.js', 'b.js' ],
175 'targets' => [ 'desktop', 'mobile' ],
177 'FileModule' => [ true,
178 [ 'class' => ResourceLoaderFileModule
::class, 'scripts' => 'example.js' ]
180 'TestModule' => [ false,
181 [ 'class' => ResourceLoaderTestModule
::class, 'scripts' => 'example.js' ]
183 'SkinModule (FileModule subclass)' => [ true,
184 [ 'class' => ResourceLoaderSkinModule
::class, 'scripts' => 'example.js' ]
186 'WikiModule' => [ false, [
187 'class' => ResourceLoaderWikiModule
::class,
188 'scripts' => [ 'MediaWiki:Example.js' ],
194 * @dataProvider provideTestIsFileModule
195 * @covers ResourceLoader::isFileModule
197 public function testIsFileModule( $expected, $module ) {
198 $rl = TestingAccessWrapper
::newFromObject( new EmptyResourceLoader() );
199 $rl->register( 'test', $module );
200 $this->assertSame( $expected, $rl->isFileModule( 'test' ) );
204 * @covers ResourceLoader::isFileModule
206 public function testIsFileModuleUnknown() {
207 $rl = TestingAccessWrapper
::newFromObject( new EmptyResourceLoader() );
208 $this->assertSame( false, $rl->isFileModule( 'unknown' ) );
212 * @covers ResourceLoader::isModuleRegistered
214 public function testIsModuleRegistered() {
215 $rl = new EmptyResourceLoader();
216 $rl->register( 'test', [] );
217 $this->assertTrue( $rl->isModuleRegistered( 'test' ) );
218 $this->assertFalse( $rl->isModuleRegistered( 'test.unknown' ) );
222 * @covers ResourceLoader::getModule
224 public function testGetModuleUnknown() {
225 $rl = new EmptyResourceLoader();
226 $this->assertSame( null, $rl->getModule( 'test' ) );
230 * @covers ResourceLoader::getModule
232 public function testGetModuleClass() {
233 $rl = new EmptyResourceLoader();
234 $rl->register( 'test', [ 'class' => ResourceLoaderTestModule
::class ] );
235 $this->assertInstanceOf(
236 ResourceLoaderTestModule
::class,
237 $rl->getModule( 'test' )
242 * @covers ResourceLoader::getModule
244 public function testGetModuleFactory() {
245 $factory = function ( array $info ) {
246 $this->assertArrayHasKey( 'kitten', $info );
247 return new ResourceLoaderTestModule( $info );
250 $rl = new EmptyResourceLoader();
251 $rl->register( 'test', [ 'factory' => $factory, 'kitten' => 'little ball of fur' ] );
252 $this->assertInstanceOf(
253 ResourceLoaderTestModule
::class,
254 $rl->getModule( 'test' )
259 * @covers ResourceLoader::getModule
261 public function testGetModuleClassDefault() {
262 $rl = new EmptyResourceLoader();
263 $rl->register( 'test', [] );
264 $this->assertInstanceOf(
265 ResourceLoaderFileModule
::class,
266 $rl->getModule( 'test' ),
267 'Array-style module registrations default to FileModule'
272 * @covers ResourceLoader::getLessCompiler
274 public function testLessImportDirs() {
275 $rl = new EmptyResourceLoader();
276 $lc = $rl->getLessCompiler( [ 'foo' => '2px', 'Foo' => '#eeeeee' ] );
277 $basePath = dirname( dirname( __DIR__
) ) . '/data/less';
278 $lc->SetImportDirs( [
279 "$basePath/common" => '',
281 $css = $lc->parseFile( "$basePath/module/use-import-dir.less" )->getCss();
282 $this->assertStringEqualsFile( "$basePath/module/styles.css", $css );
285 public static function providePackedModules() {
288 'Example from makePackedModulesString doc comment',
289 [ 'foo.bar', 'foo.baz', 'bar.baz', 'bar.quux' ],
290 'foo.bar,baz|bar.baz,quux',
293 'Example from expandModuleNames doc comment',
294 [ 'jquery.foo', 'jquery.bar', 'jquery.ui.baz', 'jquery.ui.quux' ],
295 'jquery.foo,bar|jquery.ui.baz,quux',
298 'Regression fixed in r87497 (7fee86c38e) with dotless names',
299 [ 'foo', 'bar', 'baz' ],
303 'Prefixless modules after a prefixed module',
304 [ 'single.module', 'foobar', 'foobaz' ],
305 'single.module|foobar,foobaz',
309 [ 'foo', 'foo.baz', 'baz.quux', 'foo.bar' ],
310 'foo|foo.baz,bar|baz.quux',
311 [ 'foo', 'foo.baz', 'foo.bar', 'baz.quux' ],
317 * @dataProvider providePackedModules
318 * @covers ResourceLoader::makePackedModulesString
320 public function testMakePackedModulesString( $desc, $modules, $packed ) {
321 $this->assertEquals( $packed, ResourceLoader
::makePackedModulesString( $modules ), $desc );
325 * @dataProvider providePackedModules
326 * @covers ResourceLoader::expandModuleNames
328 public function testExpandModuleNames( $desc, $modules, $packed, $unpacked = null ) {
330 $unpacked ?
: $modules,
331 ResourceLoader
::expandModuleNames( $packed ),
336 public static function provideAddSource() {
338 [ 'foowiki', 'https://example.org/w/load.php', 'foowiki' ],
339 [ 'foowiki', [ 'loadScript' => 'https://example.org/w/load.php' ], 'foowiki' ],
342 'foowiki' => 'https://example.org/w/load.php',
343 'bazwiki' => 'https://example.com/w/load.php',
346 [ 'foowiki', 'bazwiki' ]
352 * @dataProvider provideAddSource
353 * @covers ResourceLoader::addSource
354 * @covers ResourceLoader::getSources
356 public function testAddSource( $name, $info, $expected ) {
357 $rl = new EmptyResourceLoader
;
358 $rl->addSource( $name, $info );
359 if ( is_array( $expected ) ) {
360 foreach ( $expected as $source ) {
361 $this->assertArrayHasKey( $source, $rl->getSources() );
364 $this->assertArrayHasKey( $expected, $rl->getSources() );
369 * @covers ResourceLoader::addSource
371 public function testAddSourceDupe() {
372 $rl = new EmptyResourceLoader
;
373 $this->setExpectedException(
374 MWException
::class, 'ResourceLoader duplicate source addition error'
376 $rl->addSource( 'foo', 'https://example.org/w/load.php' );
377 $rl->addSource( 'foo', 'https://example.com/w/load.php' );
381 * @covers ResourceLoader::addSource
383 public function testAddSourceInvalid() {
384 $rl = new EmptyResourceLoader
;
385 $this->setExpectedException( MWException
::class, 'with no "loadScript" key' );
386 $rl->addSource( 'foo', [ 'x' => 'https://example.org/w/load.php' ] );
389 public static function provideLoaderImplement() {
392 'title' => 'Implement scripts, styles and messages',
394 'name' => 'test.example',
395 'scripts' => 'mw.example();',
396 'styles' => [ 'css' => [ '.mw-example {}' ] ],
397 'messages' => [ 'example' => '' ],
400 'expected' => 'mw.loader.implement( "test.example", function ( $, jQuery, require, module ) {
411 'title' => 'Implement scripts',
413 'name' => 'test.example',
414 'scripts' => 'mw.example();',
417 'expected' => 'mw.loader.implement( "test.example", function ( $, jQuery, require, module ) {
422 'title' => 'Implement styles',
424 'name' => 'test.example',
426 'styles' => [ 'css' => [ '.mw-example {}' ] ],
428 'expected' => 'mw.loader.implement( "test.example", [], {
435 'title' => 'Implement scripts and messages',
437 'name' => 'test.example',
438 'scripts' => 'mw.example();',
439 'messages' => [ 'example' => '' ],
441 'expected' => 'mw.loader.implement( "test.example", function ( $, jQuery, require, module ) {
448 'title' => 'Implement scripts and templates',
450 'name' => 'test.example',
451 'scripts' => 'mw.example();',
452 'templates' => [ 'example.html' => '' ],
454 'expected' => 'mw.loader.implement( "test.example", function ( $, jQuery, require, module ) {
461 'title' => 'Implement unwrapped user script',
464 'scripts' => 'mw.example( 1 );',
467 'expected' => 'mw.loader.implement( "user", "mw.example( 1 );" );',
470 'title' => 'Implement multi-file script',
472 'name' => 'test.multifile',
477 'content' => 'mw.example( 1 );',
481 'content' => [ 'n' => 2 ],
485 'content' => 'mw.example( 3 );'
488 'main' => 'three.js',
492 mw.loader.implement( "test.multifile", {
495 "one.js": function ( require, module ) {
501 "three.js": function ( require, module ) {
512 * @dataProvider provideLoaderImplement
513 * @covers ResourceLoader::makeLoaderImplementScript
514 * @covers ResourceLoader::trimArray
516 public function testMakeLoaderImplementScript( $case ) {
519 'styles' => [], 'templates' => [], 'messages' => new XmlJsCode( '{}' ), 'packageFiles' => [],
521 $rl = TestingAccessWrapper
::newFromClass( ResourceLoader
::class );
522 $context = new ResourceLoaderContext( new EmptyResourceLoader(), new FauxRequest( [
527 $rl->makeLoaderImplementScript(
530 ( $case['wrap'] && is_string( $case['scripts'] ) )
531 ?
new XmlJsCode( $case['scripts'] )
536 $case['packageFiles']
542 * @covers ResourceLoader::makeLoaderImplementScript
544 public function testMakeLoaderImplementScriptInvalid() {
545 $this->setExpectedException( MWException
::class, 'Invalid scripts error' );
546 $rl = TestingAccessWrapper
::newFromClass( ResourceLoader
::class );
547 $context = new ResourceLoaderContext( new EmptyResourceLoader(), new FauxRequest() );
548 $rl->makeLoaderImplementScript(
555 null // package files
560 * @covers ResourceLoader::makeLoaderRegisterScript
562 public function testMakeLoaderRegisterScript() {
563 $context = new ResourceLoaderContext( new EmptyResourceLoader(), new FauxRequest( [
567 'mw.loader.register([
573 ResourceLoader
::makeLoaderRegisterScript( $context, [
574 [ 'test.name', '1234567' ],
576 'Nested array parameter'
580 'mw.loader.register([
609 ResourceLoader
::makeLoaderRegisterScript( $context, [
610 [ 'test.foo', '100' , [], null, null ],
611 [ 'test.bar', '200', [ 'test.unknown' ], null ],
612 [ 'test.baz', '300', [ 'test.quux', 'test.foo' ], null ],
613 [ 'test.quux', '400', [], null, null, 'return true;' ],
615 'Compact dependency indexes'
620 * @covers ResourceLoader::makeLoaderSourcesScript
622 public function testMakeLoaderSourcesScript() {
623 $context = new ResourceLoaderContext( new EmptyResourceLoader(), new FauxRequest( [
627 'mw.loader.addSource({
628 "local": "/w/load.php"
630 ResourceLoader
::makeLoaderSourcesScript( $context, 'local', '/w/load.php' )
633 'mw.loader.addSource({
634 "local": "/w/load.php"
636 ResourceLoader
::makeLoaderSourcesScript( $context, [ 'local' => '/w/load.php' ] )
639 'mw.loader.addSource({
640 "local": "/w/load.php",
641 "example": "https://example.org/w/load.php"
643 ResourceLoader
::makeLoaderSourcesScript( $context, [
644 'local' => '/w/load.php',
645 'example' => 'https://example.org/w/load.php'
649 'mw.loader.addSource([]);',
650 ResourceLoader
::makeLoaderSourcesScript( $context, [] )
654 private static function fakeSources() {
657 'loadScript' => '//example.org/w/load.php',
658 'apiScript' => '//example.org/w/api.php',
661 'loadScript' => '//example.com/w/load.php',
662 'apiScript' => '//example.com/w/api.php',
668 * @covers ResourceLoader::getLoadScript
670 public function testGetLoadScript() {
671 $rl = new EmptyResourceLoader();
672 $sources = self
::fakeSources();
673 $rl->addSource( $sources );
674 foreach ( [ 'examplewiki', 'example2wiki' ] as $name ) {
675 $this->assertEquals( $rl->getLoadScript( $name ), $sources[$name]['loadScript'] );
679 $rl->getLoadScript( 'thiswasneverreigstered' );
680 $this->assertTrue( false, 'ResourceLoader::getLoadScript should have thrown an exception' );
681 } catch ( MWException
$e ) {
682 $this->assertTrue( true );
686 protected function getFailFerryMock( $getter = 'getScript' ) {
687 $mock = $this->getMockBuilder( ResourceLoaderTestModule
::class )
688 ->setMethods( [ $getter ] )
690 $mock->method( $getter )->will( $this->throwException(
691 new Exception( 'Ferry not found' )
696 protected function getSimpleModuleMock( $script = '' ) {
697 $mock = $this->getMockBuilder( ResourceLoaderTestModule
::class )
698 ->setMethods( [ 'getScript' ] )
700 $mock->method( 'getScript' )->willReturn( $script );
704 protected function getSimpleStyleModuleMock( $styles = '' ) {
705 $mock = $this->getMockBuilder( ResourceLoaderTestModule
::class )
706 ->setMethods( [ 'getStyles' ] )
708 $mock->method( 'getStyles' )->willReturn( [ '' => $styles ] );
713 * @covers ResourceLoader::getCombinedVersion
715 public function testGetCombinedVersion() {
716 $rl = $this->getMockBuilder( EmptyResourceLoader
::class )
717 // Disable log from outputErrorAndLog
718 ->setMethods( [ 'outputErrorAndLog' ] )->getMock();
720 'foo' => [ 'class' => ResourceLoaderTestModule
::class ],
722 'factory' => function () {
723 return self
::getFailFerryMock();
726 'bar' => [ 'class' => ResourceLoaderTestModule
::class ],
728 $context = $this->getResourceLoaderContext( [], $rl );
732 $rl->getCombinedVersion( $context, [] ),
738 $rl->getCombinedVersion( $context, [ 'foo' ] ),
742 // Verify that getCombinedVersion() does not throw when ferry fails.
743 // Instead it gracefully continues to combine the remaining modules.
745 ResourceLoader
::makeHash( self
::BLANK_VERSION
. self
::BLANK_VERSION
),
746 $rl->getCombinedVersion( $context, [ 'foo', 'ferry', 'bar' ] ),
747 'compute foo+ferry+bar (T152266)'
751 public static function provideMakeModuleResponseConcat() {
757 'expected' => "foo()\n" . 'mw.loader.state({
760 'minified' => "foo()\n" . 'mw.loader.state({"foo":"ready"});',
761 'message' => 'Script without semi-colon',
768 'expected' => "foo()\nbar()\n" . 'mw.loader.state({
772 'minified' => "foo()\nbar()\n" . 'mw.loader.state({"foo":"ready","bar":"ready"});',
773 'message' => 'Two scripts without semi-colon',
777 'foo' => "foo()\n// bar();"
779 'expected' => "foo()\n// bar();\n" . 'mw.loader.state({
782 'minified' => "foo()\n" . 'mw.loader.state({"foo":"ready"});',
783 'message' => 'Script with semi-colon in comment (T162719)',
787 foreach ( $testcases as $i => $case ) {
794 $ret["#$i (minified)"] = [
805 * Verify how multiple scripts and mw.loader.state() calls are concatenated.
807 * @dataProvider provideMakeModuleResponseConcat
808 * @covers ResourceLoader::makeModuleResponse
810 public function testMakeModuleResponseConcat( $scripts, $expected, $debug, $message = null ) {
811 $rl = new EmptyResourceLoader();
812 $modules = array_map( function ( $script ) {
813 return self
::getSimpleModuleMock( $script );
816 $context = $this->getResourceLoaderContext(
818 'modules' => implode( '|', array_keys( $modules ) ),
820 'debug' => $debug ?
'true' : 'false',
825 $response = $rl->makeModuleResponse( $context, $modules );
826 $this->assertSame( [], $rl->getErrors(), 'Errors' );
827 $this->assertEquals( $expected, $response, $message ?
: 'Response' );
831 * @covers ResourceLoader::makeModuleResponse
833 public function testMakeModuleResponseEmpty() {
834 $rl = new EmptyResourceLoader();
835 $context = $this->getResourceLoaderContext(
836 [ 'modules' => '', 'only' => 'scripts' ],
840 $response = $rl->makeModuleResponse( $context, [] );
841 $this->assertSame( [], $rl->getErrors(), 'Errors' );
842 $this->assertRegExp( '/^\/\*.+no modules were requested.+\*\/$/ms', $response );
846 * Verify that when building module content in a load.php response,
847 * an exception from one module will not break script output from
850 * @covers ResourceLoader::makeModuleResponse
852 public function testMakeModuleResponseError() {
854 'foo' => self
::getSimpleModuleMock( 'foo();' ),
855 'ferry' => self
::getFailFerryMock(),
856 'bar' => self
::getSimpleModuleMock( 'bar();' ),
858 $rl = new EmptyResourceLoader();
859 $context = $this->getResourceLoaderContext(
861 'modules' => 'foo|ferry|bar',
867 // Disable log from makeModuleResponse via outputErrorAndLog
868 $this->setLogger( 'exception', new Psr\Log\
NullLogger() );
870 $response = $rl->makeModuleResponse( $context, $modules );
871 $errors = $rl->getErrors();
873 $this->assertCount( 1, $errors );
874 $this->assertRegExp( '/Ferry not found/', $errors[0] );
876 "foo();\nbar();\n" . 'mw.loader.state({
886 * Verify that exceptions in PHP for one module will not break others
887 * (stylesheet response).
889 * @covers ResourceLoader::makeModuleResponse
891 public function testMakeModuleResponseErrorCSS() {
893 'foo' => self
::getSimpleStyleModuleMock( '.foo{}' ),
894 'ferry' => self
::getFailFerryMock( 'getStyles' ),
895 'bar' => self
::getSimpleStyleModuleMock( '.bar{}' ),
897 $rl = new EmptyResourceLoader();
898 $context = $this->getResourceLoaderContext(
900 'modules' => 'foo|ferry|bar',
907 // Disable log from makeModuleResponse via outputErrorAndLog
908 $this->setLogger( 'exception', new Psr\Log\
NullLogger() );
910 $response = $rl->makeModuleResponse( $context, $modules );
911 $errors = $rl->getErrors();
913 $this->assertCount( 2, $errors );
914 $this->assertRegExp( '/Ferry not found/', $errors[0] );
915 $this->assertRegExp( '/Problem.+"ferry":\s*"error"/ms', $errors[1] );
923 * Verify that when building the startup module response,
924 * an exception from one module class will not break the entire
925 * startup module response. See T152266.
927 * @covers ResourceLoader::makeModuleResponse
929 public function testMakeModuleResponseStartupError() {
930 // This is an integration test that uses a lot of MediaWiki state,
931 // provide the full Config object here.
932 $rl = new EmptyResourceLoader( MediaWikiServices
::getInstance()->getMainConfig() );
934 'foo' => [ 'factory' => function () {
935 return self
::getSimpleModuleMock( 'foo();' );
937 'ferry' => [ 'factory' => function () {
938 return self
::getFailFerryMock();
940 'bar' => [ 'factory' => function () {
941 return self
::getSimpleModuleMock( 'bar();' );
944 $context = $this->getResourceLoaderContext(
946 'modules' => 'startup',
953 [ 'startup', 'foo', 'ferry', 'bar' ],
954 $rl->getModuleNames(),
958 // Disable log from makeModuleResponse via outputErrorAndLog
959 $this->setLogger( 'exception', new Psr\Log\
NullLogger() );
961 $modules = [ 'startup' => $rl->getModule( 'startup' ) ];
962 $response = $rl->makeModuleResponse( $context, $modules );
963 $errors = $rl->getErrors();
965 $this->assertRegExp( '/Ferry not found/', $errors[0] );
966 $this->assertCount( 1, $errors );
968 '/isCompatible.*window\.RLQ/s',
970 'startup response undisrupted (T152266)'
973 '/register\([^)]+"ferry",\s*""/s',
975 'startup response registers broken module'
978 '/state\([^)]+"ferry":\s*"error"/s',
980 'startup response sets state to error'
985 * Integration test for modules sending extra HTTP response headers.
987 * @covers ResourceLoaderModule::getHeaders
988 * @covers ResourceLoaderModule::buildContent
989 * @covers ResourceLoader::makeModuleResponse
991 public function testMakeModuleResponseExtraHeaders() {
992 $module = $this->getMockBuilder( ResourceLoaderTestModule
::class )
993 ->setMethods( [ 'getPreloadLinks' ] )->getMock();
994 $module->method( 'getPreloadLinks' )->willReturn( [
995 'https://example.org/script.js' => [ 'as' => 'script' ],
998 $rl = new EmptyResourceLoader();
999 $context = $this->getResourceLoaderContext(
1000 [ 'modules' => 'foo', 'only' => 'scripts' ],
1004 $modules = [ 'foo' => $module ];
1005 $response = $rl->makeModuleResponse( $context, $modules );
1006 $extraHeaders = TestingAccessWrapper
::newFromObject( $rl )->extraHeaders
;
1008 $this->assertEquals(
1010 'Link: <https://example.org/script.js>;rel=preload;as=script'
1018 * @covers ResourceLoaderModule::getHeaders
1019 * @covers ResourceLoaderModule::buildContent
1020 * @covers ResourceLoader::makeModuleResponse
1022 public function testMakeModuleResponseExtraHeadersMulti() {
1023 $foo = $this->getMockBuilder( ResourceLoaderTestModule
::class )
1024 ->setMethods( [ 'getPreloadLinks' ] )->getMock();
1025 $foo->method( 'getPreloadLinks' )->willReturn( [
1026 'https://example.org/script.js' => [ 'as' => 'script' ],
1029 $bar = $this->getMockBuilder( ResourceLoaderTestModule
::class )
1030 ->setMethods( [ 'getPreloadLinks' ] )->getMock();
1031 $bar->method( 'getPreloadLinks' )->willReturn( [
1032 '/example.png' => [ 'as' => 'image' ],
1033 '/example.jpg' => [ 'as' => 'image' ],
1036 $rl = new EmptyResourceLoader();
1037 $context = $this->getResourceLoaderContext(
1038 [ 'modules' => 'foo|bar', 'only' => 'scripts' ],
1042 $modules = [ 'foo' => $foo, 'bar' => $bar ];
1043 $response = $rl->makeModuleResponse( $context, $modules );
1044 $extraHeaders = TestingAccessWrapper
::newFromObject( $rl )->extraHeaders
;
1045 $this->assertEquals(
1047 'Link: <https://example.org/script.js>;rel=preload;as=script',
1048 'Link: </example.png>;rel=preload;as=image,</example.jpg>;rel=preload;as=image'
1056 * @covers ResourceLoader::respond
1058 public function testRespondEmpty() {
1059 $rl = $this->getMockBuilder( EmptyResourceLoader
::class )
1061 'tryRespondNotModified',
1062 'sendResponseHeaders',
1063 'measureResponseTime',
1066 $context = $this->getResourceLoaderContext( [ 'modules' => '' ], $rl );
1068 $rl->expects( $this->once() )->method( 'measureResponseTime' );
1069 $this->expectOutputRegex( '/no modules were requested/' );
1071 $rl->respond( $context );
1075 * @covers ResourceLoader::respond
1077 public function testRespondSimple() {
1078 $module = new ResourceLoaderTestModule( [ 'script' => 'foo();' ] );
1079 $rl = $this->getMockBuilder( EmptyResourceLoader
::class )
1081 'measureResponseTime',
1082 'tryRespondNotModified',
1083 'sendResponseHeaders',
1084 'makeModuleResponse',
1087 $rl->register( 'test', [
1088 'factory' => function () use ( $module ) {
1092 $context = $this->getResourceLoaderContext(
1093 [ 'modules' => 'test', 'only' => null ],
1097 $rl->expects( $this->once() )->method( 'makeModuleResponse' )
1098 ->with( $context, [ 'test' => $module ] )
1099 ->willReturn( 'implement_foo;' );
1100 $this->expectOutputRegex( '/^implement_foo;/' );
1102 $rl->respond( $context );
1106 * Refuse requests for private modules.
1108 * @covers ResourceLoader::respond
1110 public function testRespondErrorPrivate() {
1111 $rl = $this->getMockBuilder( EmptyResourceLoader
::class )
1113 'measureResponseTime',
1114 'tryRespondNotModified',
1115 'sendResponseHeaders',
1119 'foo' => [ 'class' => ResourceLoaderTestModule
::class ],
1120 'bar' => [ 'class' => ResourceLoaderTestModule
::class, 'group' => 'private' ],
1122 $context = $this->getResourceLoaderContext(
1123 [ 'modules' => 'foo|bar', 'only' => null ],
1127 $this->expectOutputRegex( '/^\/\*.+Cannot build private module/s' );
1128 $rl->respond( $context );
1132 * @covers ResourceLoader::respond
1134 public function testRespondInternalFailures() {
1135 $module = new ResourceLoaderTestModule( [ 'script' => 'foo();' ] );
1136 $rl = $this->getMockBuilder( EmptyResourceLoader
::class )
1138 'measureResponseTime',
1139 'preloadModuleInfo',
1140 'getCombinedVersion',
1141 'tryRespondNotModified',
1142 'makeModuleResponse',
1143 'sendResponseHeaders',
1146 $rl->register( 'test', [
1147 'factory' => function () use ( $module ) {
1151 $context = $this->getResourceLoaderContext( [ 'modules' => 'test' ], $rl );
1152 // Disable logging from outputErrorAndLog
1153 $this->setLogger( 'exception', new Psr\Log\
NullLogger() );
1155 $rl->expects( $this->once() )->method( 'preloadModuleInfo' )
1156 ->willThrowException( new Exception( 'Preload error' ) );
1157 $rl->expects( $this->once() )->method( 'getCombinedVersion' )
1158 ->willThrowException( new Exception( 'Version error' ) );
1159 $rl->expects( $this->once() )->method( 'makeModuleResponse' )
1160 ->with( $context, [ 'test' => $module ] )
1161 ->willReturn( 'foo;' );
1162 // Internal errors should be caught and logged without affecting module output
1163 $this->expectOutputRegex( '/^\/\*.+Preload error.+Version error.+\*\/.*foo;/ms' );
1165 $rl->respond( $context );
1169 * @covers ResourceLoader::measureResponseTime
1171 public function testMeasureResponseTime() {
1172 $stats = $this->getMockBuilder( NullStatsdDataFactory
::class )
1173 ->setMethods( [ 'timing' ] )->getMock();
1174 $this->setService( 'StatsdDataFactory', $stats );
1176 $stats->expects( $this->once() )->method( 'timing' )
1177 ->with( 'resourceloader.responseTime', $this->anything() );
1179 $timing = new Timing();
1180 $timing->mark( 'requestShutdown' );
1181 $rl = TestingAccessWrapper
::newFromObject( new EmptyResourceLoader
);
1182 $rl->measureResponseTime( $timing );
1183 DeferredUpdates
::doUpdates();