UnroutedUrlTest.php

Same filename in other branches
  1. 9 core/tests/Drupal/Tests/Core/UnroutedUrlTest.php
  2. 8.9.x core/tests/Drupal/Tests/Core/UnroutedUrlTest.php
  3. 10 core/tests/Drupal/Tests/Core/UnroutedUrlTest.php

Namespace

Drupal\Tests\Core

File

core/tests/Drupal/Tests/Core/UnroutedUrlTest.php

View source
<?php

declare (strict_types=1);
namespace Drupal\Tests\Core;

use Drupal\Core\DependencyInjection\ContainerBuilder;
use Drupal\Core\Url;
use Drupal\Tests\UnitTestCase;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\Routing\Exception\ResourceNotFoundException;

/**
 * @coversDefaultClass \Drupal\Core\Url
 * @group UrlTest
 */
class UnroutedUrlTest extends UnitTestCase {
    
    /**
     * The URL assembler.
     *
     * @var \Drupal\Core\Utility\UnroutedUrlAssemblerInterface|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $urlAssembler;
    
    /**
     * The router.
     *
     * @var \Drupal\Tests\Core\Routing\TestRouterInterface|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $router;
    
    /**
     * An unrouted, external URL to test.
     *
     * @var string
     */
    protected $unroutedExternal = 'https://www.drupal.org';
    
    /**
     * An unrouted, internal URL to test.
     *
     * @var string
     */
    protected $unroutedInternal = 'base:robots.txt';
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() : void {
        parent::setUp();
        $this->urlAssembler = $this->createMock('Drupal\\Core\\Utility\\UnroutedUrlAssemblerInterface');
        $this->urlAssembler
            ->expects($this->any())
            ->method('assemble')
            ->willReturnArgument(0);
        $this->router = $this->createMock('Drupal\\Tests\\Core\\Routing\\TestRouterInterface');
        $container = new ContainerBuilder();
        $container->set('router.no_access_checks', $this->router);
        $container->set('unrouted_url_assembler', $this->urlAssembler);
        \Drupal::setContainer($container);
    }
    
    /**
     * Tests the fromUri() method.
     *
     * @covers ::fromUri
     *
     * @dataProvider providerFromUri
     */
    public function testFromUri($uri, $is_external) : void {
        $url = Url::fromUri($uri);
        $this->assertInstanceOf('Drupal\\Core\\Url', $url);
    }
    
    /**
     * Data provider for testFromUri().
     */
    public static function providerFromUri() {
        return [
            // [$uri, $is_external]
            // An external URI.
[
                'https://www.drupal.org',
                TRUE,
            ],
            // A protocol-relative URL.
[
                '//www.drupal.org',
                TRUE,
            ],
            // An internal, unrouted, base-relative URI.
[
                'base:robots.txt',
                FALSE,
            ],
            // Base-relative URIs with special characters.
[
                'base:AKI@&hO@',
                FALSE,
            ],
            [
                'base:(:;2&+h^',
                FALSE,
            ],
            // Various token formats.
[
                'base:node/[token]',
                FALSE,
            ],
            [
                'base:node/%',
                FALSE,
            ],
            [
                'base:node/[token:token]',
                FALSE,
            ],
            [
                'base:node/{{ token }}',
                FALSE,
            ],
        ];
    }
    
    /**
     * Tests the fromUri() method.
     *
     * @covers ::fromUri
     * @dataProvider providerFromInvalidUri
     */
    public function testFromInvalidUri($uri) : void {
        $this->expectException(\InvalidArgumentException::class);
        $url = Url::fromUri($uri);
    }
    
    /**
     * Data provider for testFromInvalidUri().
     */
    public static function providerFromInvalidUri() {
        return [
            // Schemeless paths.
[
                'test',
            ],
            [
                '/test',
            ],
            // Schemeless path with a query string.
[
                'foo?bar',
            ],
            // Only a query string.
[
                '?bar',
            ],
            // Only a fragment.
[
                '#foo',
            ],
            // Disallowed characters in the authority (host name) that are valid
            // elsewhere in the path.
[
                'base://(:;2&+h^',
            ],
        ];
    }
    
    /**
     * Tests the createFromRequest method.
     *
     * @covers ::createFromRequest
     */
    public function testCreateFromRequest() : void {
        $request = Request::create('/test-path');
        $this->router
            ->expects($this->once())
            ->method('matchRequest')
            ->with($request)
            ->will($this->throwException(new ResourceNotFoundException()));
        $this->expectException(ResourceNotFoundException::class);
        Url::createFromRequest($request);
    }
    
    /**
     * Tests the isExternal() method.
     *
     * @depends testFromUri
     * @dataProvider providerFromUri
     *
     * @covers ::isExternal
     */
    public function testIsExternal($uri, $is_external) : void {
        $url = Url::fromUri($uri);
        $this->assertSame($url->isExternal(), $is_external);
    }
    
    /**
     * Tests the toString() method.
     *
     * @depends testFromUri
     * @dataProvider providerFromUri
     *
     * @covers ::toString
     */
    public function testToString($uri) : void {
        $url = Url::fromUri($uri);
        $this->assertSame($uri, $url->toString());
    }
    
    /**
     * Tests the getRouteName() method.
     *
     * @depends testFromUri
     * @dataProvider providerFromUri
     *
     * @covers ::getRouteName
     */
    public function testGetRouteName($uri) : void {
        $url = Url::fromUri($uri);
        $this->expectException(\UnexpectedValueException::class);
        $url->getRouteName();
    }
    
    /**
     * Tests the getRouteParameters() method.
     *
     * @depends testFromUri
     * @dataProvider providerFromUri
     *
     * @covers ::getRouteParameters
     */
    public function testGetRouteParameters($uri) : void {
        $url = Url::fromUri($uri);
        $this->expectException(\UnexpectedValueException::class);
        $url->getRouteParameters();
    }
    
    /**
     * Tests the getInternalPath() method.
     *
     * @depends testFromUri
     * @dataProvider providerFromUri
     *
     * @covers ::getInternalPath
     */
    public function testGetInternalPath($uri) : void {
        $url = Url::fromUri($uri);
        $this->expectException(\Exception::class);
        $url->getInternalPath();
    }
    
    /**
     * Tests the getPath() method.
     *
     * @depends testFromUri
     * @dataProvider providerFromUri
     *
     * @covers ::getUri
     */
    public function testGetUri($uri) : void {
        $url = Url::fromUri($uri);
        $this->assertNotNull($url->getUri());
    }
    
    /**
     * Tests the getOptions() method.
     *
     * @depends testFromUri
     * @dataProvider providerFromUri
     *
     * @covers ::getOptions
     */
    public function testGetOptions($uri) : void {
        $url = Url::fromUri($uri);
        $this->assertIsArray($url->getOptions());
    }

}

Classes

Title Deprecated Summary
UnroutedUrlTest @coversDefaultClass \Drupal\Core\Url @group UrlTest

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