class LinkTest

Same name in other branches
  1. 8.9.x core/modules/jsonapi/tests/src/Unit/JsonApiResource/LinkTest.php \Drupal\Tests\jsonapi\Unit\JsonApiResource\LinkTest
  2. 10 core/modules/jsonapi/tests/src/Unit/JsonApiResource/LinkTest.php \Drupal\Tests\jsonapi\Unit\JsonApiResource\LinkTest
  3. 11.x core/modules/jsonapi/tests/src/Unit/JsonApiResource/LinkTest.php \Drupal\Tests\jsonapi\Unit\JsonApiResource\LinkTest

@coversDefaultClass \Drupal\jsonapi\JsonApiResource\Link @group jsonapi

@internal

Hierarchy

  • class \Drupal\Tests\UnitTestCase extends \PHPUnit\Framework\TestCase uses \Drupal\Tests\Traits\PhpUnitWarnings, \Drupal\Tests\PhpUnitCompatibilityTrait, \Symfony\Bridge\PhpUnit\ExpectDeprecationTrait
    • class \Drupal\Tests\jsonapi\Unit\JsonApiResource\LinkTest extends \Drupal\Tests\UnitTestCase

Expanded class hierarchy of LinkTest

File

core/modules/jsonapi/tests/src/Unit/JsonApiResource/LinkTest.php, line 19

Namespace

Drupal\Tests\jsonapi\Unit\JsonApiResource
View source 
class LinkTest extends UnitTestCase {
    
    /**
     * @covers ::compare
     * @dataProvider linkComparisonProvider
     */
    public function testLinkComparison(Link $a, Link $b, $expected) {
        $actual = Link::compare($a, $b);
        $this->assertSame($expected, $actual === 0);
    }
    
    /**
     * Provides test data for link comparison.
     */
    public function linkComparisonProvider() {
        $this->mockUrlAssembler();
        return [
            'same href and same link relation type' => [
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/foo'), 'self'),
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/foo'), 'self'),
                TRUE,
            ],
            'different href and same link relation type' => [
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/foo'), 'self'),
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/bar'), 'self'),
                FALSE,
            ],
            'same href and different link relation type' => [
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/foo'), 'self'),
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/foo'), 'related'),
                FALSE,
            ],
            'same href and same link relation type and empty target attributes' => [
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/foo'), 'self', []),
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/foo'), 'self', []),
                TRUE,
            ],
            'same href and same link relation type and same target attributes' => [
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/foo'), 'self', [
                    'anchor' => 'https://jsonapi.org',
                ]),
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/foo'), 'self', [
                    'anchor' => 'https://jsonapi.org',
                ]),
                TRUE,
            ],
            // These links are not considered equivalent because it would while the
            // `href` remains the same, the anchor changes the context of the link.
'same href and same link relation type and different target attributes' => [
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/boy'), 'self', [
                    'title' => 'sue',
                ]),
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/boy'), 'self', [
                    'anchor' => '/sob',
                    'title' => 'pa',
                ]),
                FALSE,
            ],
            'same href and same link relation type and same nested target attributes' => [
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/foo'), 'self', [
                    'data' => [
                        'foo' => 'bar',
                    ],
                ]),
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/foo'), 'self', [
                    'data' => [
                        'foo' => 'bar',
                    ],
                ]),
                TRUE,
            ],
            'same href and same link relation type and different nested target attributes' => [
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/foo'), 'self', [
                    'data' => [
                        'foo' => 'bar',
                    ],
                ]),
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/foo'), 'self', [
                    'data' => [
                        'foo' => 'baz',
                    ],
                ]),
                FALSE,
            ],
            // These links are not considered equivalent because it would be unclear
            // which title corresponds to which link relation type.
'same href and different link relation types and different target attributes' => [
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/boy'), 'self', [
                    'title' => 'A boy named Sue',
                ]),
                new Link(new CacheableMetadata(), Url::fromUri('https://jsonapi.org/boy'), 'edit', [
                    'title' => 'Change name to Bill or George',
                ]),
                FALSE,
            ],
        ];
    }
    
    /**
     * @covers ::merge
     * @dataProvider linkMergeProvider
     */
    public function testLinkMerge(Link $a, Link $b, $expected) {
        if ($expected instanceof Link) {
            $this->assertSame($expected->getCacheTags(), Link::merge($a, $b)->getCacheTags());
        }
        else {
            $this->expectExceptionObject($expected);
            Link::merge($a, $b);
        }
    }
    
    /**
     * Provides test data for link merging.
     */
    public function linkMergeProvider() {
        $this->mockUrlAssembler();
        return [
            'same everything' => [
                new Link((new CacheableMetadata())->addCacheTags([
                    'foo',
                ]), Url::fromUri('https://jsonapi.org/foo'), 'self'),
                new Link((new CacheableMetadata())->addCacheTags([
                    'foo',
                ]), Url::fromUri('https://jsonapi.org/foo'), 'self'),
                new Link((new CacheableMetadata())->addCacheTags([
                    'foo',
                ]), Url::fromUri('https://jsonapi.org/foo'), 'self'),
            ],
            'different cache tags' => [
                new Link((new CacheableMetadata())->addCacheTags([
                    'foo',
                ]), Url::fromUri('https://jsonapi.org/foo'), 'self'),
                new Link((new CacheableMetadata())->addCacheTags([
                    'bar',
                ]), Url::fromUri('https://jsonapi.org/foo'), 'self'),
                new Link((new CacheableMetadata())->addCacheTags([
                    'foo',
                    'bar',
                ]), Url::fromUri('https://jsonapi.org/foo'), 'self'),
            ],
        ];
    }
    
    /**
     * @covers ::getLinkRelationType
     */
    public function testGetLinkRelationType() {
        $this->mockUrlAssembler();
        $link = new Link((new CacheableMetadata())->addCacheTags([
            'foo',
        ]), Url::fromUri('https://jsonapi.org/foo'), 'self');
        $this->assertSame('self', $link->getLinkRelationType());
    }
    
    /**
     * Mocks the unrouted URL assembler.
     */
    protected function mockUrlAssembler() {
        $url_assembler = $this->getMockBuilder(UnroutedUrlAssemblerInterface::class)
            ->disableOriginalConstructor()
            ->getMock();
        $url_assembler->method('assemble')
            ->willReturnCallback(function ($uri) {
            return (new GeneratedUrl())->setGeneratedUrl($uri);
        });
        $container = new ContainerBuilder();
        $container->set('unrouted_url_assembler', $url_assembler);
        \Drupal::setContainer($container);
    }

}

Members

Title Deprecated Modifiers Object type Summary Overrides
LinkTest::linkComparisonProvider public function Provides test data for link comparison.
LinkTest::linkMergeProvider public function Provides test data for link merging.
LinkTest::mockUrlAssembler protected function Mocks the unrouted URL assembler.
LinkTest::testGetLinkRelationType public function @covers ::getLinkRelationType
LinkTest::testLinkComparison public function @covers ::compare
@dataProvider linkComparisonProvider
LinkTest::testLinkMerge public function @covers ::merge
@dataProvider linkMergeProvider
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.
UnitTestCase::$randomGenerator protected property The random generator.
UnitTestCase::$root protected property The app root. 1
UnitTestCase::assertArrayEquals Deprecated protected function Asserts if two arrays are equal by sorting them first.
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.
UnitTestCase::setUp protected function 338
UnitTestCase::setUpBeforeClass public static function

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