class ChainedPlaceholderStrategyTest in Drupal 8

@coversDefaultClass \Drupal\Core\Render\Placeholder\ChainedPlaceholderStrategy @group Render

Hierarchy

• class \Drupal\Tests\UnitTestCase extends \PHPUnit\Framework\TestCase uses PhpunitCompatibilityTrait
  • class \Drupal\Tests\Core\Render\Placeholder\ChainedPlaceholderStrategyTest

File

core/tests/Drupal/Tests/Core/Render/Placeholder/ChainedPlaceholderStrategyTest.php, line 12

Namespace

Drupal\Tests\Core\Render\Placeholder

class ChainedPlaceholderStrategyTest extends UnitTestCase {

  /**
   * @covers ::addPlaceholderStrategy
   * @covers ::processPlaceholders
   *
   * @dataProvider providerProcessPlaceholders
   */
  public function testProcessPlaceholders($strategies, $placeholders, $result) {
    $chained_placeholder_strategy = new ChainedPlaceholderStrategy();
    foreach ($strategies as $strategy) {
      $chained_placeholder_strategy
        ->addPlaceholderStrategy($strategy);
    }
    $this
      ->assertEquals($result, $chained_placeholder_strategy
      ->processPlaceholders($placeholders));
  }

  /**
   * Provides a list of render strategies, placeholders and results.
   *
   * @return array
   */
  public function providerProcessPlaceholders() {
    $data = [];

    // Empty placeholders.
    $data['empty placeholders'] = [
      [],
      [],
      [],
    ];

    // Placeholder removing strategy.
    $placeholders = [
      'remove-me' => [
        '#markup' => 'I-am-a-llama-that-will-be-removed-sad-face.',
      ],
    ];
    $prophecy = $this
      ->prophesize('\\Drupal\\Core\\Render\\Placeholder\\PlaceholderStrategyInterface');
    $prophecy
      ->processPlaceholders($placeholders)
      ->willReturn([]);
    $dev_null_strategy = $prophecy
      ->reveal();
    $data['placeholder removing strategy'] = [
      [
        $dev_null_strategy,
      ],
      $placeholders,
      [],
    ];

    // Fake Single Flush strategy.
    $placeholders = [
      '67890' => [
        '#markup' => 'special-placeholder',
      ],
    ];
    $prophecy = $this
      ->prophesize('\\Drupal\\Core\\Render\\Placeholder\\PlaceholderStrategyInterface');
    $prophecy
      ->processPlaceholders($placeholders)
      ->willReturn($placeholders);
    $single_flush_strategy = $prophecy
      ->reveal();
    $data['fake single flush strategy'] = [
      [
        $single_flush_strategy,
      ],
      $placeholders,
      $placeholders,
    ];

    // Fake ESI strategy.
    $placeholders = [
      '12345' => [
        '#markup' => 'special-placeholder-for-esi',
      ],
    ];
    $result = [
      '12345' => [
        '#markup' => '<esi:include src="/fragment/12345" />',
      ],
    ];
    $prophecy = $this
      ->prophesize('\\Drupal\\Core\\Render\\Placeholder\\PlaceholderStrategyInterface');
    $prophecy
      ->processPlaceholders($placeholders)
      ->willReturn($result);
    $esi_strategy = $prophecy
      ->reveal();
    $data['fake esi strategy'] = [
      [
        $esi_strategy,
      ],
      $placeholders,
      $result,
    ];

    // ESI + SingleFlush strategy (ESI replaces all).
    $prophecy = $this
      ->prophesize('\\Drupal\\Core\\Render\\Placeholder\\PlaceholderStrategyInterface');
    $prophecy
      ->processPlaceholders($placeholders)
      ->willReturn($result);
    $esi_strategy = $prophecy
      ->reveal();
    $prophecy = $this
      ->prophesize('\\Drupal\\Core\\Render\\Placeholder\\PlaceholderStrategyInterface');
    $prophecy
      ->processPlaceholders($placeholders)
      ->shouldNotBeCalled();
    $prophecy
      ->processPlaceholders($result)
      ->shouldNotBeCalled();
    $prophecy
      ->processPlaceholders([])
      ->shouldNotBeCalled();
    $single_flush_strategy = $prophecy
      ->reveal();
    $data['fake esi and single_flush strategy - esi replaces all'] = [
      [
        $esi_strategy,
        $single_flush_strategy,
      ],
      $placeholders,
      $result,
    ];

    // ESI + SingleFlush strategy (mixed).
    $placeholders = [
      '12345' => [
        '#markup' => 'special-placeholder-for-ESI',
      ],
      '67890' => [
        '#markup' => 'special-placeholder',
      ],
      'foo' => [
        '#markup' => 'bar',
      ],
    ];
    $esi_result = [
      '12345' => [
        '#markup' => '<esi:include src="/fragment/12345" />',
      ],
    ];
    $normal_result = [
      '67890' => [
        '#markup' => 'special-placeholder',
      ],
      'foo' => [
        '#markup' => 'bar',
      ],
    ];
    $result = $esi_result + $normal_result;
    $prophecy = $this
      ->prophesize('\\Drupal\\Core\\Render\\Placeholder\\PlaceholderStrategyInterface');
    $prophecy
      ->processPlaceholders($placeholders)
      ->willReturn($esi_result);
    $esi_strategy = $prophecy
      ->reveal();
    $prophecy = $this
      ->prophesize('\\Drupal\\Core\\Render\\Placeholder\\PlaceholderStrategyInterface');
    $prophecy
      ->processPlaceholders($normal_result)
      ->willReturn($normal_result);
    $single_flush_strategy = $prophecy
      ->reveal();
    $data['fake esi and single_flush strategy - mixed'] = [
      [
        $esi_strategy,
        $single_flush_strategy,
      ],
      $placeholders,
      $result,
    ];
    return $data;
  }

  /**
   * @covers ::processPlaceholders
   */
  public function testProcessPlaceholdersNoStrategies() {

    // Placeholders but no strategies defined.
    $placeholders = [
      'assert-me' => [
        '#markup' => 'I-am-a-llama-that-will-lead-to-an-assertion-by-the-chained-placeholder-strategy.',
      ],
    ];
    $chained_placeholder_strategy = new ChainedPlaceholderStrategy();
    $this
      ->expectException(\AssertionError::class);
    $this
      ->expectExceptionMessage('At least one placeholder strategy must be present; by default the fallback strategy \\Drupal\\Core\\Render\\Placeholder\\SingleFlushStrategy is always present.');
    $chained_placeholder_strategy
      ->processPlaceholders($placeholders);
  }

  /**
   * @covers ::processPlaceholders
   */
  public function testProcessPlaceholdersWithRoguePlaceholderStrategy() {

    // Placeholders but no strategies defined.
    $placeholders = [
      'assert-me' => [
        '#markup' => 'llama',
      ],
    ];
    $result = [
      'assert-me' => [
        '#markup' => 'llama',
      ],
      'new-placeholder' => [
        '#markup' => 'rogue llama',
      ],
    ];
    $prophecy = $this
      ->prophesize('\\Drupal\\Core\\Render\\Placeholder\\PlaceholderStrategyInterface');
    $prophecy
      ->processPlaceholders($placeholders)
      ->willReturn($result);
    $rogue_strategy = $prophecy
      ->reveal();
    $chained_placeholder_strategy = new ChainedPlaceholderStrategy();
    $chained_placeholder_strategy
      ->addPlaceholderStrategy($rogue_strategy);
    $this
      ->expectException(\AssertionError::class);
    $this
      ->expectExceptionMessage('Processed placeholders must be a subset of all placeholders.');
    $chained_placeholder_strategy
      ->processPlaceholders($placeholders);
  }

}

Members

Name	Modifiers	Type	Description	Overrides
ChainedPlaceholderStrategyTest::providerProcessPlaceholders	public	function	Provides a list of render strategies, placeholders and results.
ChainedPlaceholderStrategyTest::testProcessPlaceholders	public	function	@covers ::addPlaceholderStrategy @covers ::processPlaceholders
ChainedPlaceholderStrategyTest::testProcessPlaceholdersNoStrategies	public	function	@covers ::processPlaceholders
ChainedPlaceholderStrategyTest::testProcessPlaceholdersWithRoguePlaceholderStrategy	public	function	@covers ::processPlaceholders
PhpunitCompatibilityTrait::getMock Deprecated	public	function	Returns a mock object for the specified class using the available method.
PhpunitCompatibilityTrait::setExpectedException Deprecated	public	function	Compatibility layer for PHPUnit 6 to support PHPUnit 4 code.
UnitTestCase::$randomGenerator	protected	property	The random generator.
UnitTestCase::$root	protected	property	The app root.	1
UnitTestCase::assertArrayEquals	protected	function	Asserts if two arrays are equal by sorting them first.
UnitTestCase::getBlockMockWithMachineName Deprecated	protected	function	Mocks a block with a block plugin.	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::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		340