class LibraryDiscoveryParserTest in Drupal 8

@coversDefaultClass \Drupal\Core\Asset\LibraryDiscoveryParser @group Asset

Hierarchy

• class \Drupal\Tests\UnitTestCase extends \PHPUnit\Framework\TestCase uses PhpunitCompatibilityTrait
  • class \Drupal\Tests\Core\Asset\LibraryDiscoveryParserTest

File

core/tests/Drupal/Tests/Core/Asset/LibraryDiscoveryParserTest.php, line 22

Contains \Drupal\Tests\Core\Asset\LibraryDiscoveryParserTest.

Namespace

Drupal\Tests\Core\Asset

class LibraryDiscoveryParserTest extends UnitTestCase {

  /**
   * The tested library discovery parser service.
   *
   * @var \Drupal\Core\Asset\LibraryDiscoveryParser|\Drupal\Tests\Core\Asset\TestLibraryDiscoveryParser
   */
  protected $libraryDiscoveryParser;

  /**
   * The mocked cache backend.
   *
   * @var \Drupal\Core\Cache\CacheBackendInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $cache;

  /**
   * The mocked module handler.
   *
   * @var \Drupal\Core\Extension\ModuleHandlerInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $moduleHandler;

  /**
   * The mocked theme manager.
   *
   * @var \Drupal\Core\Theme\ThemeManagerInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $themeManager;

  /**
   * The mocked lock backend.
   *
   * @var \Drupal\Core\Lock\LockBackendInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $lock;

  /**
   * The mocked stream wrapper manager.
   *
   * @var \Drupal\Core\StreamWrapper\StreamWrapperManagerInterface||\PHPUnit\Framework\MockObject\MockObject
   */
  protected $streamWrapperManager;

  /**
   * The mocked libraries directory file finder.
   *
   * @var \Drupal\Core\Asset\LibrariesDirectoryFileFinder||\PHPUnit\Framework\MockObject\MockObject
   */
  protected $librariesDirectoryFileFinder;

  /**
   * {@inheritdoc}
   */
  protected function setUp() {
    parent::setUp();
    $this->moduleHandler = $this
      ->createMock('Drupal\\Core\\Extension\\ModuleHandlerInterface');
    $this->themeManager = $this
      ->createMock('Drupal\\Core\\Theme\\ThemeManagerInterface');
    $mock_active_theme = $this
      ->getMockBuilder('Drupal\\Core\\Theme\\ActiveTheme')
      ->disableOriginalConstructor()
      ->getMock();
    $mock_active_theme
      ->expects($this
      ->any())
      ->method('getLibrariesOverride')
      ->willReturn([]);
    $this->themeManager
      ->expects($this
      ->any())
      ->method('getActiveTheme')
      ->willReturn($mock_active_theme);
    $this->streamWrapperManager = $this
      ->createMock(StreamWrapperManagerInterface::class);
    $this->librariesDirectoryFileFinder = $this
      ->createMock(LibrariesDirectoryFileFinder::class);
    $this->libraryDiscoveryParser = new TestLibraryDiscoveryParser($this->root, $this->moduleHandler, $this->themeManager, $this->streamWrapperManager, $this->librariesDirectoryFileFinder);
  }

  /**
   * Tests that basic functionality works for getLibraryByName.
   *
   * @covers ::buildByExtension
   */
  public function testBuildByExtensionSimple() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('example_module')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'example_module', $path);
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('example_module');
    $library = $libraries['example'];
    $this
      ->assertCount(0, $library['js']);
    $this
      ->assertCount(1, $library['css']);
    $this
      ->assertCount(0, $library['dependencies']);
    $this
      ->assertEquals($path . '/css/example.css', $library['css'][0]['data']);

    // Ensures that VERSION is replaced by the current core version.
    $this
      ->assertEquals(\Drupal::VERSION, $library['version']);
  }

  /**
   * Tests that a theme can be used instead of a module.
   *
   * @covers ::buildByExtension
   */
  public function testBuildByExtensionWithTheme() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('example_theme')
      ->will($this
      ->returnValue(FALSE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('theme', 'example_theme', $path);
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('example_theme');
    $library = $libraries['example'];
    $this
      ->assertCount(0, $library['js']);
    $this
      ->assertCount(1, $library['css']);
    $this
      ->assertCount(0, $library['dependencies']);
    $this
      ->assertEquals($path . '/css/example.css', $library['css'][0]['data']);
  }

  /**
   * Tests that a module with a missing library file results in FALSE.
   *
   * @covers ::buildByExtension
   */
  public function testBuildByExtensionWithMissingLibraryFile() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('example_module')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files_not_existing';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'example_module', $path);
    $this
      ->assertSame($this->libraryDiscoveryParser
      ->buildByExtension('example_module'), []);
  }

  /**
   * Tests that an exception is thrown when a libraries file couldn't be parsed.
   *
   * @covers ::buildByExtension
   */
  public function testInvalidLibrariesFile() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('invalid_file')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'invalid_file', $path);
    $this
      ->expectException(InvalidLibraryFileException::class);
    $this->libraryDiscoveryParser
      ->buildByExtension('invalid_file');
  }

  /**
   * Tests that no exception is thrown when only dependencies are specified.
   *
   * @covers ::buildByExtension
   */
  public function testBuildByExtensionWithOnlyDependencies() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('example_module_only_dependencies')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'example_module_only_dependencies', $path);
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('example_module_only_dependencies');
    $this
      ->assertArrayHasKey('example', $libraries);
  }

  /**
   * Tests that an exception is thrown with only the version property specified.
   *
   * @covers ::buildByExtension
   */
  public function testBuildByExtensionWithMissingInformation() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('example_module_missing_information')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'example_module_missing_information', $path);
    $this
      ->expectException(IncompleteLibraryDefinitionException::class);
    $this
      ->expectExceptionMessage("Incomplete library definition for definition 'example' in extension 'example_module_missing_information'");
    $this->libraryDiscoveryParser
      ->buildByExtension('example_module_missing_information');
  }

  /**
   * Tests the version property, and how it propagates to the contained assets.
   *
   * @covers ::buildByExtension
   */
  public function testVersion() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('versions')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'versions', $path);
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('versions');
    $this
      ->assertArrayNotHasKey('version', $libraries['versionless']);
    $this
      ->assertEquals(-1, $libraries['versionless']['css'][0]['version']);
    $this
      ->assertEquals(-1, $libraries['versionless']['js'][0]['version']);
    $this
      ->assertEquals('9.8.7.6', $libraries['versioned']['version']);
    $this
      ->assertEquals('9.8.7.6', $libraries['versioned']['css'][0]['version']);
    $this
      ->assertEquals('9.8.7.6', $libraries['versioned']['js'][0]['version']);
    $this
      ->assertEquals(\Drupal::VERSION, $libraries['core-versioned']['version']);
    $this
      ->assertEquals(\Drupal::VERSION, $libraries['core-versioned']['css'][0]['version']);
    $this
      ->assertEquals(\Drupal::VERSION, $libraries['core-versioned']['js'][0]['version']);
  }

  /**
   * Tests that the version property of external libraries is handled.
   *
   * @covers ::buildByExtension
   */
  public function testExternalLibraries() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('external')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'external', $path);
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('external');
    $library = $libraries['example_external'];
    $this
      ->assertEquals('http://example.com/css/example_external.css', $library['css'][0]['data']);
    $this
      ->assertEquals('http://example.com/example_external.js', $library['js'][0]['data']);
    $this
      ->assertEquals('3.14', $library['version']);
  }

  /**
   * Ensures that CSS weights are taken into account properly.
   *
   * @covers ::buildByExtension
   */
  public function testDefaultCssWeights() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('css_weights')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'css_weights', $path);
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('css_weights');
    $library = $libraries['example'];
    $css = $library['css'];
    $this
      ->assertCount(10, $css);

    // The following default weights are tested:
    // - CSS_BASE: -200
    // - CSS_LAYOUT: -100
    // - CSS_COMPONENT: 0
    // - CSS_STATE: 100
    // - CSS_THEME: 200
    $this
      ->assertEquals(200, $css[0]['weight']);
    $this
      ->assertEquals(200 + 29, $css[1]['weight']);
    $this
      ->assertEquals(-200, $css[2]['weight']);
    $this
      ->assertEquals(-200 + 97, $css[3]['weight']);
    $this
      ->assertEquals(-100, $css[4]['weight']);
    $this
      ->assertEquals(-100 + 92, $css[5]['weight']);
    $this
      ->assertEquals(0, $css[6]['weight']);
    $this
      ->assertEquals(45, $css[7]['weight']);
    $this
      ->assertEquals(100, $css[8]['weight']);
    $this
      ->assertEquals(100 + 8, $css[9]['weight']);
  }

  /**
   * Ensures that you cannot provide positive weights for JavaScript libraries.
   *
   * @covers ::buildByExtension
   */
  public function testJsWithPositiveWeight() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('js_positive_weight')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'js_positive_weight', $path);
    $this
      ->expectException(\UnexpectedValueException::class);
    $this->libraryDiscoveryParser
      ->buildByExtension('js_positive_weight');
  }

  /**
   * Tests a library with CSS/JavaScript and a setting.
   *
   * @covers ::buildByExtension
   */
  public function testLibraryWithCssJsSetting() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('css_js_settings')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'css_js_settings', $path);
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('css_js_settings');
    $library = $libraries['example'];

    // Ensures that the group and type are set automatically.
    $this
      ->assertEquals(-100, $library['js'][0]['group']);
    $this
      ->assertEquals('file', $library['js'][0]['type']);
    $this
      ->assertEquals($path . '/js/example.js', $library['js'][0]['data']);
    $this
      ->assertEquals(0, $library['css'][0]['group']);
    $this
      ->assertEquals('file', $library['css'][0]['type']);
    $this
      ->assertEquals($path . '/css/base.css', $library['css'][0]['data']);
    $this
      ->assertEquals([
      'key' => 'value',
    ], $library['drupalSettings']);
  }

  /**
   * Tests a library with dependencies.
   *
   * @covers ::buildByExtension
   */
  public function testLibraryWithDependencies() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('dependencies')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'dependencies', $path);
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('dependencies');
    $library = $libraries['example'];
    $this
      ->assertCount(2, $library['dependencies']);
    $this
      ->assertEquals('external/example_external', $library['dependencies'][0]);
    $this
      ->assertEquals('example_module/example', $library['dependencies'][1]);
  }

  /**
   * Tests a library with a couple of data formats like full URL.
   *
   * @covers ::buildByExtension
   */
  public function testLibraryWithDataTypes() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('data_types')
      ->will($this
      ->returnValue(TRUE));
    $this->streamWrapperManager
      ->expects($this
      ->atLeastOnce())
      ->method('isValidUri')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'data_types', $path);
    $this->libraryDiscoveryParser
      ->setFileValidUri('public://test.css', TRUE);
    $this->libraryDiscoveryParser
      ->setFileValidUri('public://test2.css', FALSE);
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('data_types');
    $library = $libraries['example'];
    $this
      ->assertCount(5, $library['css']);
    $this
      ->assertEquals('external', $library['css'][0]['type']);
    $this
      ->assertEquals('http://example.com/test.css', $library['css'][0]['data']);
    $this
      ->assertEquals('file', $library['css'][1]['type']);
    $this
      ->assertEquals('tmp/test.css', $library['css'][1]['data']);
    $this
      ->assertEquals('external', $library['css'][2]['type']);
    $this
      ->assertEquals('//cdn.com/test.css', $library['css'][2]['data']);
    $this
      ->assertEquals('file', $library['css'][3]['type']);
    $this
      ->assertEquals('public://test.css', $library['css'][3]['data']);
  }

  /**
   * Tests a library with JavaScript-specific flags.
   *
   * @covers ::buildByExtension
   */
  public function testLibraryWithJavaScript() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('js')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'js', $path);
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('js');
    $library = $libraries['example'];
    $this
      ->assertCount(2, $library['js']);
    $this
      ->assertEquals(FALSE, $library['js'][0]['minified']);
    $this
      ->assertEquals(TRUE, $library['js'][1]['minified']);
  }

  /**
   * Tests that an exception is thrown when license is missing when 3rd party.
   *
   * @covers ::buildByExtension
   */
  public function testLibraryThirdPartyWithMissingLicense() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('licenses_missing_information')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'licenses_missing_information', $path);
    $this
      ->expectException(LibraryDefinitionMissingLicenseException::class);
    $this
      ->expectExceptionMessage("Missing license information in library definition for definition 'no-license-info-but-remote' extension 'licenses_missing_information': it has a remote, but no license.");
    $this->libraryDiscoveryParser
      ->buildByExtension('licenses_missing_information');
  }

  /**
   * Tests a library with various licenses, some GPL-compatible, some not.
   *
   * @covers ::buildByExtension
   */
  public function testLibraryWithLicenses() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('licenses')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'licenses', $path);
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('licenses');

    // For libraries without license info, the default license is applied.
    $library = $libraries['no-license-info'];
    $this
      ->assertCount(1, $library['css']);
    $this
      ->assertCount(1, $library['js']);
    $this
      ->assertTrue(isset($library['license']));
    $default_license = [
      'name' => 'GNU-GPL-2.0-or-later',
      'url' => 'https://www.drupal.org/licensing/faq',
      'gpl-compatible' => TRUE,
    ];
    $this
      ->assertEquals($library['license'], $default_license);

    // GPL2-licensed libraries.
    $library = $libraries['gpl2'];
    $this
      ->assertCount(1, $library['css']);
    $this
      ->assertCount(1, $library['js']);
    $expected_license = [
      'name' => 'gpl2',
      'url' => 'https://url-to-gpl2-license',
      'gpl-compatible' => TRUE,
    ];
    $this
      ->assertEquals($library['license'], $expected_license);

    // MIT-licensed libraries.
    $library = $libraries['mit'];
    $this
      ->assertCount(1, $library['css']);
    $this
      ->assertCount(1, $library['js']);
    $expected_license = [
      'name' => 'MIT',
      'url' => 'https://url-to-mit-license',
      'gpl-compatible' => TRUE,
    ];
    $this
      ->assertEquals($library['license'], $expected_license);

    // Libraries in the Public Domain.
    $library = $libraries['public-domain'];
    $this
      ->assertCount(1, $library['css']);
    $this
      ->assertCount(1, $library['js']);
    $expected_license = [
      'name' => 'Public Domain',
      'url' => 'https://url-to-public-domain-license',
      'gpl-compatible' => TRUE,
    ];
    $this
      ->assertEquals($library['license'], $expected_license);

    // Apache-licensed libraries.
    $library = $libraries['apache'];
    $this
      ->assertCount(1, $library['css']);
    $this
      ->assertCount(1, $library['js']);
    $expected_license = [
      'name' => 'apache',
      'url' => 'https://url-to-apache-license',
      'gpl-compatible' => FALSE,
    ];
    $this
      ->assertEquals($library['license'], $expected_license);

    // Copyrighted libraries.
    $library = $libraries['copyright'];
    $this
      ->assertCount(1, $library['css']);
    $this
      ->assertCount(1, $library['js']);
    $expected_license = [
      'name' => '© Some company',
      'gpl-compatible' => FALSE,
    ];
    $this
      ->assertEquals($library['license'], $expected_license);
  }

  /**
   * Verifies assertions catch invalid CSS declarations.
   *
   * @dataProvider providerTestCssAssert
   */

  /**
   * Verify an assertion fails if CSS declarations have non-existent categories.
   *
   * @param string $extension
   *   The css extension to build.
   * @param string $exception_message
   *   The expected exception message.
   *
   * @dataProvider providerTestCssAssert
   */
  public function testCssAssert($extension, $exception_message) {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with($extension)
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', $extension, $path);
    $this
      ->expectException(\AssertionError::class);
    $this
      ->expectExceptionMessage($exception_message);
    $this->libraryDiscoveryParser
      ->buildByExtension($extension);
  }

  /**
   * Data provider for testing bad CSS declarations.
   */
  public function providerTestCssAssert() {
    return [
      'css_bad_category' => [
        'css_bad_category',
        'See https://www.drupal.org/node/2274843.',
      ],
      'Improper CSS nesting' => [
        'css_bad_nesting',
        'CSS must be nested under a category. See https://www.drupal.org/node/2274843.',
      ],
      'Improper CSS nesting array' => [
        'css_bad_nesting_array',
        'CSS files should be specified as key/value pairs, where the values are configuration options. See https://www.drupal.org/node/2274843.',
      ],
    ];
  }

  /**
   * @covers ::buildByExtension
   */
  public function testNonCoreLibrariesFound() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('example_contrib_module')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'example_contrib_module', $path);
    $this->librariesDirectoryFileFinder
      ->expects($this
      ->once())
      ->method('find')
      ->with('third_party_library/css/example.css')
      ->will($this
      ->returnValue('sites/example.com/libraries/third_party_library/css/example.css'));
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('example_contrib_module');
    $library = $libraries['third_party_library'];
    $this
      ->assertCount(0, $library['js']);
    $this
      ->assertCount(1, $library['css']);
    $this
      ->assertCount(0, $library['dependencies']);

    // The location is determined by the libraries directory file finder.
    $this
      ->assertEquals('sites/example.com/libraries/third_party_library/css/example.css', $library['css'][0]['data']);
  }

  /**
   * @covers ::buildByExtension
   */
  public function testNonCoreLibrariesNotFound() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('example_contrib_module')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'example_contrib_module', $path);
    $this->libraryDiscoveryParser
      ->setPaths('profile', 'library_testing', 'profiles/library_testing');
    $this->librariesDirectoryFileFinder
      ->expects($this
      ->once())
      ->method('find')
      ->with('third_party_library/css/example.css')
      ->will($this
      ->returnValue(FALSE));
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('example_contrib_module');
    $library = $libraries['third_party_library'];
    $this
      ->assertCount(0, $library['js']);
    $this
      ->assertCount(1, $library['css']);
    $this
      ->assertCount(0, $library['dependencies']);

    // The location will be the same as provided in the library definition even
    // though it does not exist.
    $this
      ->assertEquals('libraries/third_party_library/css/example.css', $library['css'][0]['data']);
  }

  /**
   * @covers ::parseLibraryInfo
   */
  public function testEmptyLibraryFile() {
    $this->moduleHandler
      ->expects($this
      ->atLeastOnce())
      ->method('moduleExists')
      ->with('empty')
      ->will($this
      ->returnValue(TRUE));
    $path = __DIR__ . '/library_test_files';
    $path = substr($path, strlen($this->root) + 1);
    $this->libraryDiscoveryParser
      ->setPaths('module', 'empty', $path);
    $libraries = $this->libraryDiscoveryParser
      ->buildByExtension('empty');
    $this
      ->assertEquals([], $libraries);
  }

}

Members

Name	Modifiers	Type	Description	Overrides
LibraryDiscoveryParserTest::$cache	protected	property	The mocked cache backend.
LibraryDiscoveryParserTest::$librariesDirectoryFileFinder	protected	property	The mocked libraries directory file finder.
LibraryDiscoveryParserTest::$libraryDiscoveryParser	protected	property	The tested library discovery parser service.
LibraryDiscoveryParserTest::$lock	protected	property	The mocked lock backend.
LibraryDiscoveryParserTest::$moduleHandler	protected	property	The mocked module handler.
LibraryDiscoveryParserTest::$streamWrapperManager	protected	property	The mocked stream wrapper manager.
LibraryDiscoveryParserTest::$themeManager	protected	property	The mocked theme manager.
LibraryDiscoveryParserTest::providerTestCssAssert	public	function	Data provider for testing bad CSS declarations.
LibraryDiscoveryParserTest::setUp	protected	function	Overrides UnitTestCase::setUp
LibraryDiscoveryParserTest::testBuildByExtensionSimple	public	function	Tests that basic functionality works for getLibraryByName.
LibraryDiscoveryParserTest::testBuildByExtensionWithMissingInformation	public	function	Tests that an exception is thrown with only the version property specified.
LibraryDiscoveryParserTest::testBuildByExtensionWithMissingLibraryFile	public	function	Tests that a module with a missing library file results in FALSE.
LibraryDiscoveryParserTest::testBuildByExtensionWithOnlyDependencies	public	function	Tests that no exception is thrown when only dependencies are specified.
LibraryDiscoveryParserTest::testBuildByExtensionWithTheme	public	function	Tests that a theme can be used instead of a module.
LibraryDiscoveryParserTest::testCssAssert	public	function	Verify an assertion fails if CSS declarations have non-existent categories.
LibraryDiscoveryParserTest::testDefaultCssWeights	public	function	Ensures that CSS weights are taken into account properly.
LibraryDiscoveryParserTest::testEmptyLibraryFile	public	function	@covers ::parseLibraryInfo
LibraryDiscoveryParserTest::testExternalLibraries	public	function	Tests that the version property of external libraries is handled.
LibraryDiscoveryParserTest::testInvalidLibrariesFile	public	function	Tests that an exception is thrown when a libraries file couldn't be parsed.
LibraryDiscoveryParserTest::testJsWithPositiveWeight	public	function	Ensures that you cannot provide positive weights for JavaScript libraries.
LibraryDiscoveryParserTest::testLibraryThirdPartyWithMissingLicense	public	function	Tests that an exception is thrown when license is missing when 3rd party.
LibraryDiscoveryParserTest::testLibraryWithCssJsSetting	public	function	Tests a library with CSS/JavaScript and a setting.
LibraryDiscoveryParserTest::testLibraryWithDataTypes	public	function	Tests a library with a couple of data formats like full URL.
LibraryDiscoveryParserTest::testLibraryWithDependencies	public	function	Tests a library with dependencies.
LibraryDiscoveryParserTest::testLibraryWithJavaScript	public	function	Tests a library with JavaScript-specific flags.
LibraryDiscoveryParserTest::testLibraryWithLicenses	public	function	Tests a library with various licenses, some GPL-compatible, some not.
LibraryDiscoveryParserTest::testNonCoreLibrariesFound	public	function	@covers ::buildByExtension
LibraryDiscoveryParserTest::testNonCoreLibrariesNotFound	public	function	@covers ::buildByExtension
LibraryDiscoveryParserTest::testVersion	public	function	Tests the version property, and how it propagates to the contained assets.
PhpunitCompatibilityTrait::getMock Deprecated	public	function	Returns a mock object for the specified class using the available method.
PhpunitCompatibilityTrait::setExpectedException Deprecated	public	function	Compatibility layer for PHPUnit 6 to support PHPUnit 4 code.
UnitTestCase::$randomGenerator	protected	property	The random generator.
UnitTestCase::$root	protected	property	The app root.	1
UnitTestCase::assertArrayEquals	protected	function	Asserts if two arrays are equal by sorting them first.
UnitTestCase::getBlockMockWithMachineName Deprecated	protected	function	Mocks a block with a block plugin.	1
UnitTestCase::getClassResolverStub	protected	function	Returns a stub class resolver.
UnitTestCase::getConfigFactoryStub	public	function	Returns a stub config factory that behaves according to the passed array.
UnitTestCase::getConfigStorageStub	public	function	Returns a stub config storage that returns the supplied configuration.
UnitTestCase::getContainerWithCacheTagsInvalidator	protected	function	Sets up a container with a cache tags invalidator.
UnitTestCase::getRandomGenerator	protected	function	Gets the random generator for the utility methods.
UnitTestCase::getStringTranslationStub	public	function	Returns a stub translation manager that just returns the passed string.
UnitTestCase::randomMachineName	public	function	Generates a unique random string containing letters and numbers.