class RouteMatchTestBase

Same name 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. 10 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 Modifiers Object type Summary Overrides
ExpectDeprecationTrait::expectDeprecation public function Adds an expected deprecation.
ExpectDeprecationTrait::getCallableName private static function Returns a callable as a string suitable for inclusion in a message.
ExpectDeprecationTrait::setUpErrorHandler public function Sets up the test error handler.
ExpectDeprecationTrait::tearDownErrorHandler public function Tears down the test error handler.
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.
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
@covers \Drupal\Core\Routing\RouteMatch::getParameterNames
@dataProvider routeMatchProvider
RouteMatchTestBase::testGetParameters public function @covers ::getParameters
@covers \Drupal\Core\Routing\RouteMatch::getParameterNames
@dataProvider routeMatchProvider
RouteMatchTestBase::testGetRawParameter public function @covers ::getRawParameter
@covers \Drupal\Core\Routing\RouteMatch::getParameterNames
@dataProvider routeMatchProvider
RouteMatchTestBase::testGetRawParameters public function @covers ::getRawParameters
@covers \Drupal\Core\Routing\RouteMatch::getParameterNames
@dataProvider routeMatchProvider
RouteMatchTestBase::testGetRouteName public function @covers ::getRouteName
@dataProvider routeMatchProvider
RouteMatchTestBase::testGetRouteObject public function @covers ::getRouteObject
@dataProvider routeMatchProvider
UnitTestCase::$root protected property The app root.
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 356
UnitTestCase::setUpBeforeClass public static function

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