Same name and namespace in other branches
  1. 8.9.x core/modules/jsonapi/tests/src/Unit/JsonApiResource/LinkTest.php \Drupal\Tests\jsonapi\Unit\JsonApiResource\LinkTest
  2. 9 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\PhpUnitCompatibilityTrait, \Prophecy\PhpUnit\ProphecyTrait, \Symfony\Bridge\PhpUnit\ExpectDeprecationTrait, RandomGeneratorTrait, PhpUnitWarnings
    • class \Drupal\Tests\jsonapi\Unit\JsonApiResource\LinkTest

Expanded class hierarchy of LinkTest

File

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

Namespace

Drupal\Tests\jsonapi\Unit\JsonApiResource
View source 
class LinkTest extends UnitTestCase {

  /**
   * @covers ::compare
   * @dataProvider linkComparisonProvider
   */
  public function testLinkComparison(array $a, array $b, bool $expected) : void {
    $this
      ->mockUrlAssembler();
    $link_a = new Link(new CacheableMetadata(), Url::fromUri($a[0]), $a[1], $a[2] ?? []);
    $link_b = new Link(new CacheableMetadata(), Url::fromUri($b[0]), $b[1], $b[2] ?? []);
    $actual = Link::compare($link_a, $link_b);
    $this
      ->assertSame($expected, $actual === 0);
  }

  /**
   * Provides test data for link comparison.
   */
  public static function linkComparisonProvider() : \Generator {
    (yield 'same href and same link relation type' => [
      [
        'https://jsonapi.org/foo',
        'self',
      ],
      [
        'https://jsonapi.org/foo',
        'self',
      ],
      TRUE,
    ]);
    (yield 'different href and same link relation type' => [
      [
        'https://jsonapi.org/foo',
        'self',
      ],
      [
        'https://jsonapi.org/bar',
        'self',
      ],
      FALSE,
    ]);
    (yield 'same href and different link relation type' => [
      [
        'https://jsonapi.org/foo',
        'self',
      ],
      [
        'https://jsonapi.org/foo',
        'related',
      ],
      FALSE,
    ]);
    (yield 'same href and same link relation type and empty target attributes' => [
      [
        'https://jsonapi.org/foo',
        'self',
        [],
      ],
      [
        'https://jsonapi.org/foo',
        'self',
        [],
      ],
      TRUE,
    ]);
    (yield 'same href and same link relation type and same target attributes' => [
      [
        'https://jsonapi.org/foo',
        'self',
        [
          'anchor' => 'https://jsonapi.org',
        ],
      ],
      [
        '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.
    (yield 'same href and same link relation type and different target attributes' => [
      [
        'https://jsonapi.org/boy',
        'self',
        [
          'title' => 'sue',
        ],
      ],
      [
        'https://jsonapi.org/boy',
        'self',
        [
          'anchor' => '/sob',
          'title' => 'pa',
        ],
      ],
      FALSE,
    ]);
    (yield 'same href and same link relation type and same nested target attributes' => [
      [
        'https://jsonapi.org/foo',
        'self',
        [
          'data' => [
            'foo' => 'bar',
          ],
        ],
      ],
      [
        'https://jsonapi.org/foo',
        'self',
        [
          'data' => [
            'foo' => 'bar',
          ],
        ],
      ],
      TRUE,
    ]);
    (yield 'same href and same link relation type and different nested target attributes' => [
      [
        'https://jsonapi.org/foo',
        'self',
        [
          'data' => [
            'foo' => 'bar',
          ],
        ],
      ],
      [
        '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.
    (yield 'same href and different link relation types and different target attributes' => [
      [
        'https://jsonapi.org/boy',
        'self',
        [
          'title' => 'A boy named Sue',
        ],
      ],
      [
        'https://jsonapi.org/boy',
        'edit',
        [
          'title' => 'Change name to Bill or George',
        ],
      ],
      FALSE,
    ]);
  }

  /**
   * @covers ::merge
   * @dataProvider linkMergeProvider
   */
  public function testLinkMerge(array $a, array $b, array $expected) : void {
    $this
      ->mockUrlAssembler();
    $link_a = new Link((new CacheableMetadata())
      ->addCacheTags($a[0]), Url::fromUri($a[1]), $a[2]);
    $link_b = new Link((new CacheableMetadata())
      ->addCacheTags($b[0]), Url::fromUri($b[1]), $b[2]);
    $link_expected = new Link((new CacheableMetadata())
      ->addCacheTags($expected[0]), Url::fromUri($expected[1]), $expected[2]);
    $this
      ->assertSame($link_expected
      ->getCacheTags(), Link::merge($link_a, $link_b)
      ->getCacheTags());
  }

  /**
   * Provides test data for link merging.
   */
  public static function linkMergeProvider() : \Generator {
    (yield 'same everything' => [
      [
        [
          'foo',
        ],
        'https://jsonapi.org/foo',
        'self',
      ],
      [
        [
          'foo',
        ],
        'https://jsonapi.org/foo',
        'self',
      ],
      [
        [
          'foo',
        ],
        'https://jsonapi.org/foo',
        'self',
      ],
    ]);
    (yield 'different cache tags' => [
      [
        [
          'foo',
        ],
        'https://jsonapi.org/foo',
        'self',
      ],
      [
        [
          'bar',
        ],
        'https://jsonapi.org/foo',
        'self',
      ],
      [
        [
          'foo',
          'bar',
        ],
        '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

Namesort descending Modifiers Type Description Overrides
LinkTest::linkComparisonProvider public static function Provides test data for link comparison.
LinkTest::linkMergeProvider public static 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.
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.
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 305
UnitTestCase::setUpBeforeClass public static function
UnitTestCase::__get public function