class ComponentValidatorTest

Same name in this branch
  1. 10 core/modules/sdc/tests/src/Unit/ComponentValidatorTest.php \Drupal\Tests\sdc\Unit\ComponentValidatorTest
Same name and namespace in other branches
  1. 11.x core/modules/sdc/tests/src/Unit/ComponentValidatorTest.php \Drupal\Tests\sdc\Unit\ComponentValidatorTest
  2. 11.x core/tests/Drupal/Tests/Core/Theme/Component/ComponentValidatorTest.php \Drupal\Tests\Core\Theme\Component\ComponentValidatorTest

Unit tests for the component validation.

@coversDefaultClass \Drupal\Core\Theme\Component\ComponentValidator
@group sdc

Hierarchy

Expanded class hierarchy of ComponentValidatorTest

File

core/tests/Drupal/Tests/Core/Theme/Component/ComponentValidatorTest.php, line 20

Namespace

Drupal\Tests\Core\Theme\Component
View source
class ComponentValidatorTest extends TestCase {
  
  /**
   * Tests that valid component definitions don't cause errors.
   *
   * @dataProvider dataProviderValidateDefinitionValid
   *
   * @throws \Drupal\Core\Render\Component\Exception\InvalidComponentException
   */
  public function testValidateDefinitionValid(array $definition) : void {
    $component_validator = new ComponentValidator();
    $component_validator->setValidator();
    $this->assertTrue($component_validator->validateDefinition($definition, TRUE), 'The invalid component definition did not throw an error.');
  }
  
  /**
   * Data provider with valid component definitions.
   *
   * @return array
   *   The data.
   */
  public static function dataProviderValidateDefinitionValid() : array {
    return [
      array_map([
        static::class,
        'loadComponentDefinitionFromFs',
      ], [
        'my-banner',
        'my-button',
        'my-cta',
      ]),
    ];
  }
  
  /**
   * Tests invalid component definitions.
   *
   * @dataProvider dataProviderValidateDefinitionInvalid
   */
  public function testValidateDefinitionInvalid(array $definition) : void {
    $this->expectException(InvalidComponentException::class);
    $component_validator = new ComponentValidator();
    $component_validator->setValidator();
    $component_validator->validateDefinition($definition, TRUE);
  }
  
  /**
   * Data provider with invalid component definitions.
   *
   * @return array
   *   The data.
   */
  public static function dataProviderValidateDefinitionInvalid() : array {
    $valid_cta = static::loadComponentDefinitionFromFs('my-cta');
    $cta_with_missing_required = $valid_cta;
    unset($cta_with_missing_required['path']);
    $cta_with_invalid_class = $valid_cta;
    $cta_with_invalid_class['props']['properties']['attributes']['type'] = 'Drupal\\Foo\\Invalid';
    $cta_with_invalid_enum = array_merge($valid_cta, [
      'extension_type' => 'invalid',
    ]);
    return [
      [
        $cta_with_missing_required,
      ],
      [
        $cta_with_invalid_class,
      ],
      [
        $cta_with_invalid_enum,
      ],
    ];
  }
  
  /**
   * Tests that valid props are handled properly.
   *
   * @dataProvider dataProviderValidatePropsValid
   *
   * @throws \Drupal\Core\Render\Component\Exception\InvalidComponentException
   */
  public function testValidatePropsValid(array $context, string $component_id, array $definition) : void {
    $component = new Component([
      'app_root' => '/fake/path/root',
    ], 'sdc_test:' . $component_id, $definition);
    $component_validator = new ComponentValidator();
    $component_validator->setValidator();
    $this->assertTrue($component_validator->validateProps($context, $component), 'The valid component props threw an error.');
  }
  
  /**
   * Data provider with valid component props.
   *
   * @return array
   *   The data.
   */
  public static function dataProviderValidatePropsValid() : array {
    return [
      [
        [
          'text' => 'Can Pica',
          'href' => 'https://www.drupal.org',
          'target' => '_blank',
          'attributes' => new Attribute([
            'key' => 'value',
          ]),
        ],
        'my-cta',
        static::loadComponentDefinitionFromFs('my-cta'),
      ],
      [
        [],
        'my-banner',
        static::loadComponentDefinitionFromFs('my-banner'),
      ],
      [
        [
          'nonProp' => new \stdClass(),
        ],
        'my-banner',
        static::loadComponentDefinitionFromFs('my-banner'),
      ],
    ];
  }
  
  /**
   * Tests that invalid props are handled properly.
   *
   * @dataProvider dataProviderValidatePropsInvalid
   *
   * @throws \Drupal\Core\Render\Component\Exception\InvalidComponentException
   */
  public function testValidatePropsInvalid(array $context, string $component_id, array $definition) : void {
    $component = new Component([
      'app_root' => '/fake/path/root',
    ], 'sdc_test:' . $component_id, $definition);
    $this->expectException(InvalidComponentException::class);
    $component_validator = new ComponentValidator();
    $component_validator->setValidator();
    $component_validator->validateProps($context, $component);
  }
  
  /**
   * Data provider with invalid component props.
   *
   * @return array
   *   The data.
   */
  public static function dataProviderValidatePropsInvalid() : array {
    return [
      'missing required prop' => [
        [
          'href' => 'https://www.drupal.org',
          'target' => '_blank',
          'attributes' => new Attribute([
            'key' => 'value',
          ]),
        ],
        'my-cta',
        static::loadComponentDefinitionFromFs('my-cta'),
      ],
      'attributes with invalid object class' => [
        [
          'text' => 'Can Pica',
          'href' => 'https://www.drupal.org',
          'target' => '_blank',
          'attributes' => new \stdClass(),
        ],
        'my-cta',
        static::loadComponentDefinitionFromFs('my-cta'),
      ],
      'ctaTarget violates the allowed properties in the enum' => [
        [
          'ctaTarget' => 'foo',
        ],
        'my-banner',
        static::loadComponentDefinitionFromFs('my-banner'),
      ],
    ];
  }
  
  /**
   * Loads a component definition from the component name.
   *
   * @param string $component_name
   *   The component name.
   *
   * @return array
   *   The component definition
   */
  private static function loadComponentDefinitionFromFs(string $component_name) : array {
    return array_merge(Yaml::parseFile(sprintf('%s/modules/system/tests/modules/sdc_test/components/%s/%s.component.yml', dirname(__DIR__, 6), $component_name, $component_name)), [
      'machineName' => $component_name,
      'extension_type' => 'module',
      'id' => 'sdc_test:' . $component_name,
      'library' => [
        'css' => [
          'component' => [
            'foo.css' => [],
          ],
        ],
      ],
      'path' => '',
      'provider' => 'sdc_test',
      'template' => $component_name . '.twig',
      'group' => 'my-group',
      'description' => 'My description',
    ]);
  }

}

Members

Title Sort descending Modifiers Object type Summary
ComponentValidatorTest::dataProviderValidateDefinitionInvalid public static function Data provider with invalid component definitions.
ComponentValidatorTest::dataProviderValidateDefinitionValid public static function Data provider with valid component definitions.
ComponentValidatorTest::dataProviderValidatePropsInvalid public static function Data provider with invalid component props.
ComponentValidatorTest::dataProviderValidatePropsValid public static function Data provider with valid component props.
ComponentValidatorTest::loadComponentDefinitionFromFs private static function Loads a component definition from the component name.
ComponentValidatorTest::testValidateDefinitionInvalid public function Tests invalid component definitions.
ComponentValidatorTest::testValidateDefinitionValid public function Tests that valid component definitions don't cause errors.
ComponentValidatorTest::testValidatePropsInvalid public function Tests that invalid props are handled properly.
ComponentValidatorTest::testValidatePropsValid public function Tests that valid props are handled properly.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.