ResourcesTest.php

Go to the documentation of this file.

<?php
 
use MediaWiki\MediaWikiServices;
use Wikimedia\TestingAccessWrapper;
 
class ResourcesTest extends MediaWikiTestCase {
 
    public function testFileExistence( $filename, $module, $resource ) {
        $this->assertFileExists( $filename,
            "File '$resource' referenced by '$module' must exist."
        );
    }
 
    public function testStyleMedia( $moduleName, $media, $filename, $css ) {
        $cssText = CSSMin::minify( $css->cssText );
 
        $this->assertTrue(
            strpos( $cssText, '@media' ) === false,
            'Stylesheets should not both specify "media" and contain @media'
        );
    }
 
    public function testVersionHash() {
        $data = self::getAllModules();
        foreach ( $data['modules'] as $moduleName => $module ) {
            $version = $module->getVersionHash( $data['context'] );
            $this->assertEquals( 7, strlen( $version ), "$moduleName must use ResourceLoader::makeHash" );
        }
    }
 
    public function testIllegalDependencies() {
        $data = self::getAllModules();
 
        $illegalDeps = [];
        foreach ( $data['modules'] as $moduleName => $module ) {
            if ( $module->isRaw() ) {
                $illegalDeps[] = $moduleName;
            }
        }
 
        foreach ( $data['modules'] as $moduleName => $module ) {
            foreach ( $illegalDeps as $illegalDep ) {
                $this->assertNotContains(
                    $illegalDep,
                    $module->getDependencies( $data['context'] ),
                    "Module '$moduleName' must not depend on '$illegalDep'"
                );
            }
        }
    }
 
    public function testMissingDependencies() {
        $data = self::getAllModules();
        $validDeps = array_keys( $data['modules'] );
 
        foreach ( $data['modules'] as $moduleName => $module ) {
            foreach ( $module->getDependencies( $data['context'] ) as $dep ) {
                $this->assertContains(
                    $dep,
                    $validDeps,
                    "The module '$dep' required by '$moduleName' must exist"
                );
            }
        }
    }
 
    public function testMissingMessages() {
        $data = self::getAllModules();
        $lang = Language::factory( 'en' );
 
        foreach ( $data['modules'] as $moduleName => $module ) {
            foreach ( $module->getMessages() as $msgKey ) {
                $this->assertTrue(
                    wfMessage( $msgKey )->useDatabase( false )->inLanguage( $lang )->exists(),
                    "Message '$msgKey' required by '$moduleName' must exist"
                );
            }
        }
    }
 
    public function testUnsatisfiableDependencies() {
        $data = self::getAllModules();
 
        foreach ( $data['modules'] as $moduleName => $module ) {
            $moduleTargets = $module->getTargets();
            foreach ( $module->getDependencies( $data['context'] ) as $dep ) {
                if ( !isset( $data['modules'][$dep] ) ) {
                    // Missing dependencies reported by testMissingDependencies
                    continue;
                }
                $targets = $data['modules'][$dep]->getTargets();
                foreach ( $moduleTargets as $moduleTarget ) {
                    $this->assertContains(
                        $moduleTarget,
                        $targets,
                        "The module '$moduleName' must not have target '$moduleTarget' "
                            . "because its dependency '$dep' does not have it"
                    );
                }
            }
        }
    }
 
    public function testCommentedLocalFileReferences() {
        $basepath = __DIR__ . '/../data/css/';
        $css = file_get_contents( $basepath . 'comments.css' );
        $files = CSSMin::getLocalFileReferences( $css, $basepath );
        $expected = [ $basepath . 'not-commented.gif' ];
        $this->assertSame(
            $expected,
            $files,
            'Url(...) expression in comment should be omitted.'
        );
    }
 
    protected static function getAllModules() {
        global $wgEnableJavaScriptTest;
 
        // Test existance of test suite files as well
        // (can't use setUp or setMwGlobals because providers are static)
        $org_wgEnableJavaScriptTest = $wgEnableJavaScriptTest;
        $wgEnableJavaScriptTest = true;
 
        // Get main ResourceLoader
        $rl = MediaWikiServices::getInstance()->getResourceLoader();
 
        $modules = [];
 
        foreach ( $rl->getModuleNames() as $moduleName ) {
            $modules[$moduleName] = $rl->getModule( $moduleName );
        }
 
        // Restore settings
        $wgEnableJavaScriptTest = $org_wgEnableJavaScriptTest;
 
        return [
            'modules' => $modules,
            'resourceloader' => $rl,
            'context' => new ResourceLoaderContext( $rl, new FauxRequest() )
        ];
    }
 
    public static function provideMediaStylesheets() {
        $data = self::getAllModules();
        $cases = [];
 
        foreach ( $data['modules'] as $moduleName => $module ) {
            if ( !$module instanceof ResourceLoaderFileModule ) {
                continue;
            }
 
            $reflectedModule = new ReflectionObject( $module );
 
            $getStyleFiles = $reflectedModule->getMethod( 'getStyleFiles' );
            $getStyleFiles->setAccessible( true );
 
            $readStyleFile = $reflectedModule->getMethod( 'readStyleFile' );
            $readStyleFile->setAccessible( true );
 
            $styleFiles = $getStyleFiles->invoke( $module, $data['context'] );
 
            $flip = $module->getFlip( $data['context'] );
 
            foreach ( $styleFiles as $media => $files ) {
                if ( $media && $media !== 'all' ) {
                    foreach ( $files as $file ) {
                        $cases[] = [
                            $moduleName,
                            $media,
                            $file,
                            // XXX: Wrapped in an object to keep it out of PHPUnit output
                            (object)[
                                'cssText' => $readStyleFile->invoke(
                                    $module,
                                    $file,
                                    $flip,
                                    $data['context']
                                )
                            ],
                        ];
                    }
                }
            }
        }
 
        return $cases;
    }
 
    public static function provideResourceFiles() {
        $data = self::getAllModules();
        $cases = [];
 
        // See also ResourceLoaderFileModule::__construct
        $filePathProps = [
            // Lists of file paths
            'lists' => [
                'scripts',
                'debugScripts',
                'styles',
            ],
 
            // Collated lists of file paths
            'nested-lists' => [
                'languageScripts',
                'skinScripts',
                'skinStyles',
            ],
        ];
 
        foreach ( $data['modules'] as $moduleName => $module ) {
            if ( !$module instanceof ResourceLoaderFileModule ) {
                continue;
            }
 
            $moduleProxy = TestingAccessWrapper::newFromObject( $module );
 
            $files = [];
 
            foreach ( $filePathProps['lists'] as $propName ) {
                $list = $moduleProxy->$propName;
                foreach ( $list as $key => $value ) {
                    // 'scripts' are numeral arrays.
                    // 'styles' can be numeral or associative.
                    // In case of associative the key is the file path
                    // and the value is the 'media' attribute.
                    if ( is_int( $key ) ) {
                        $files[] = $value;
                    } else {
                        $files[] = $key;
                    }
                }
            }
 
            foreach ( $filePathProps['nested-lists'] as $propName ) {
                $lists = $moduleProxy->$propName;
                foreach ( $lists as $list ) {
                    foreach ( $list as $key => $value ) {
                        // We need the same filter as for 'lists',
                        // due to 'skinStyles'.
                        if ( is_int( $key ) ) {
                            $files[] = $value;
                        } else {
                            $files[] = $key;
                        }
                    }
                }
            }
 
            // Populate cases
            foreach ( $files as $file ) {
                $cases[] = [
                    $moduleProxy->getLocalPath( $file ),
                    $moduleName,
                    ( $file instanceof ResourceLoaderFilePath ? $file->getPath() : $file ),
                ];
            }
 
            // To populate missingLocalFileRefs. Not sure how sane this is inside this test...
            $moduleProxy->readStyleFiles(
                $module->getStyleFiles( $data['context'] ),
                $module->getFlip( $data['context'] ),
                $data['context']
            );
 
            $missingLocalFileRefs = $moduleProxy->missingLocalFileRefs;
 
            foreach ( $missingLocalFileRefs as $file ) {
                $cases[] = [
                    $file,
                    $moduleName,
                    $file,
                ];
            }
        }
 
        return $cases;
    }
}