class RouteMatchTestBase

Same name and namespace in other branches
  1. 9 core/tests/Drupal/Tests/Core/Routing/RouteMatchTestBase.php \Drupal\Tests\Core\Routing\RouteMatchTestBase
  2. 8.9.x core/tests/Drupal/Tests/Core/Routing/RouteMatchTestBase.php \Drupal\Tests\Core\Routing\RouteMatchTestBase
  3. 11.x core/tests/Drupal/Tests/Core/Routing/RouteMatchTestBase.php \Drupal\Tests\Core\Routing\RouteMatchTestBase

Base test class for testing classes implementing the route match interface.

@coversDefaultClass \Drupal\Core\Routing\RouteMatch

Hierarchy

Expanded class hierarchy of RouteMatchTestBase

File

core/tests/Drupal/Tests/Core/Routing/RouteMatchTestBase.php, line 16

Namespace

Drupal\Tests\Core\Routing
View source
abstract class RouteMatchTestBase extends UnitTestCase {
  
  /**
   * Build a test route match object for the given implementation.
   *
   * @param string $name
   *   Route name.
   * @param \Symfony\Component\Routing\Route $route
   *   Request object
   * @param array $parameters
   *   Parameters array
   * @param array $raw_parameters
   *   Raw parameters array
   *
   * @return \Drupal\Core\Routing\RouteMatchInterface
   */
  protected static abstract function getRouteMatch(string $name, Route $route, array $parameters, array $raw_parameters) : RouteMatchInterface;
  
  /**
   * Provide sets of parameters and expected parameters for parameter tests.
   */
  public static function routeMatchProvider() : array {
    $base_data = [
      [
        new Route('/test-route/{param_without_leading_underscore}/{_param_with_leading_underscore}', [
          'default_without_leading_underscore' => NULL,
          '_default_with_leading_underscore' => NULL,
        ]),
        [
          'param_without_leading_underscore' => 'value',
          '_param_with_leading_underscore' => 'value',
          'default_without_leading_underscore' => 'value',
          '_default_with_leading_underscore' => 'value',
          'foo' => 'value',
        ],
        // Parameters should be filtered to only those defined by the route.
        // Specifically:
        // - Path parameters, regardless of name.
        // - Defaults that are not path parameters only if they do not start with
        //   an underscore.
[
          'param_without_leading_underscore' => 'value',
          '_param_with_leading_underscore' => 'value',
          'default_without_leading_underscore' => 'value',
        ],
      ],
    ];
    $data = [];
    foreach ($base_data as $entry) {
      $route = $entry[0];
      $params = $entry[1];
      $expected_params = $entry[2];
      $data[] = [
        static::getRouteMatch('test_route', $route, $params, $params),
        $route,
        $params,
        $expected_params,
      ];
    }
    return $data;
  }
  
  /**
   * @covers ::getRouteName
   * @dataProvider routeMatchProvider
   */
  public function testGetRouteName(RouteMatchInterface $route_match) : void {
    $this->assertSame('test_route', $route_match->getRouteName());
  }
  
  /**
   * @covers ::getRouteObject
   * @dataProvider routeMatchProvider
   */
  public function testGetRouteObject(RouteMatchInterface $route_match, Route $route) : void {
    $this->assertSame($route, $route_match->getRouteObject());
  }
  
  /**
   * @covers ::getParameter
   * @covers \Drupal\Core\Routing\RouteMatch::getParameterNames
   * @dataProvider routeMatchProvider
   */
  public function testGetParameter(RouteMatchInterface $route_match, Route $route, array $parameters, array $expected_filtered_parameters) : void {
    foreach ($expected_filtered_parameters as $name => $expected_value) {
      $this->assertSame($expected_value, $route_match->getParameter($name));
    }
    foreach (array_diff_key($parameters, $expected_filtered_parameters) as $name) {
      $this->assertNull($route_match->getParameter($name));
    }
  }
  
  /**
   * @covers ::getParameters
   * @covers \Drupal\Core\Routing\RouteMatch::getParameterNames
   * @dataProvider routeMatchProvider
   */
  public function testGetParameters(RouteMatchInterface $route_match, Route $route, array $parameters, array $expected_filtered_parameters) : void {
    $this->assertSame($expected_filtered_parameters, $route_match->getParameters()
      ->all());
  }
  
  /**
   * @covers ::getRawParameter
   * @covers \Drupal\Core\Routing\RouteMatch::getParameterNames
   * @dataProvider routeMatchProvider
   */
  public function testGetRawParameter(RouteMatchInterface $route_match, Route $route, array $parameters, array $expected_filtered_parameters) : void {
    foreach ($expected_filtered_parameters as $name => $expected_value) {
      $this->assertSame($expected_value, $route_match->getRawParameter($name));
    }
    foreach (array_diff_key($parameters, $expected_filtered_parameters) as $name) {
      $this->assertNull($route_match->getRawParameter($name));
    }
  }
  
  /**
   * @covers ::getRawParameters
   * @covers \Drupal\Core\Routing\RouteMatch::getParameterNames
   * @dataProvider routeMatchProvider
   */
  public function testGetRawParameters(RouteMatchInterface $route_match, Route $route, array $parameters, array $expected_filtered_parameters) : void {
    $this->assertSame($expected_filtered_parameters, $route_match->getRawParameters()
      ->all());
  }

}

Members

Title Sort descending Deprecated Modifiers Object type Summary Overrides
PhpUnitWarnings::$deprecationWarnings private static property Deprecation warnings from PHPUnit to raise with @trigger_error().
PhpUnitWarnings::addWarning public function Converts PHPUnit deprecation warnings to E_USER_DEPRECATED.
RandomGeneratorTrait::getRandomGenerator protected function Gets the random generator for the utility methods.
RandomGeneratorTrait::randomMachineName protected function Generates a unique random string containing letters and numbers.
RandomGeneratorTrait::randomObject public function Generates a random PHP object.
RandomGeneratorTrait::randomString public function Generates a pseudo-random string of ASCII characters of codes 32 to 126.
RandomGeneratorTrait::randomStringValidate Deprecated public function Callback for random string validation.
RouteMatchTestBase::getRouteMatch abstract protected static function Build a test route match object for the given implementation. 2
RouteMatchTestBase::routeMatchProvider public static function Provide sets of parameters and expected parameters for parameter tests.
RouteMatchTestBase::testGetParameter public function @covers ::getParameter[[api-linebreak]]
@covers \Drupal\Core\Routing\RouteMatch::getParameterNames[[api-linebreak]]
@dataProvider routeMatchProvider
RouteMatchTestBase::testGetParameters public function @covers ::getParameters[[api-linebreak]]
@covers \Drupal\Core\Routing\RouteMatch::getParameterNames[[api-linebreak]]
@dataProvider routeMatchProvider
RouteMatchTestBase::testGetRawParameter public function @covers ::getRawParameter[[api-linebreak]]
@covers \Drupal\Core\Routing\RouteMatch::getParameterNames[[api-linebreak]]
@dataProvider routeMatchProvider
RouteMatchTestBase::testGetRawParameters public function @covers ::getRawParameters[[api-linebreak]]
@covers \Drupal\Core\Routing\RouteMatch::getParameterNames[[api-linebreak]]
@dataProvider routeMatchProvider
RouteMatchTestBase::testGetRouteName public function @covers ::getRouteName[[api-linebreak]]
@dataProvider routeMatchProvider
RouteMatchTestBase::testGetRouteObject public function @covers ::getRouteObject[[api-linebreak]]
@dataProvider routeMatchProvider
UnitTestCase::$root protected property The app root. 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::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::setUp protected function 358
UnitTestCase::setUpBeforeClass public static function
UnitTestCase::__get public function

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