class RendererTest in Drupal 9

@coversDefaultClass \Drupal\Core\Render\Renderer @group Render

Hierarchy

• class \Drupal\Tests\UnitTestCase extends \PHPUnit\Framework\TestCase uses \Symfony\Bridge\PhpUnit\ExpectDeprecationTrait, PhpUnitCompatibilityTrait, PhpUnitWarnings
  • class \Drupal\Tests\Core\Render\RendererTestBase
    • class \Drupal\Tests\Core\Render\RendererTest

File

core/tests/Drupal/Tests/Core/Render/RendererTest.php, line 23

Contains \Drupal\Tests\Core\Render\RendererTest.

Namespace

Drupal\Tests\Core\Render

class RendererTest extends RendererTestBase {
  protected $defaultThemeVars = [
    '#cache' => [
      'contexts' => [
        'languages:language_interface',
        'theme',
      ],
      'tags' => [],
      'max-age' => Cache::PERMANENT,
    ],
    '#attached' => [],
    '#children' => '',
  ];

  /**
   * @covers ::render
   * @covers ::doRender
   *
   * @dataProvider providerTestRenderBasic
   */
  public function testRenderBasic($build, $expected, callable $setup_code = NULL) {
    if (isset($setup_code)) {
      $setup_code = $setup_code
        ->bindTo($this);
      $setup_code();
    }
    if (isset($build['#markup'])) {
      $this
        ->assertNotInstanceOf(MarkupInterface::class, $build['#markup']);
    }
    $render_output = $this->renderer
      ->renderRoot($build);
    $this
      ->assertSame($expected, (string) $render_output);
    if ($render_output !== '') {
      $this
        ->assertInstanceOf(MarkupInterface::class, $render_output);
      $this
        ->assertInstanceOf(MarkupInterface::class, $build['#markup']);
    }
  }

  /**
   * Provides a list of render arrays to test basic rendering.
   *
   * @return array
   */
  public function providerTestRenderBasic() {
    $data = [];

    // Part 1: the most simplistic render arrays possible, none using #theme.
    // Pass a NULL.
    $data[] = [
      NULL,
      '',
    ];

    // Pass an empty string.
    $data[] = [
      '',
      '',
    ];

    // Previously printed, see ::renderTwice for a more integration-like test.
    $data[] = [
      [
        '#markup' => 'foo',
        '#printed' => TRUE,
      ],
      '',
    ];

    // Printed in pre_render.
    $data[] = [
      [
        '#markup' => 'foo',
        '#pre_render' => [
          [
            new TestCallables(),
            'preRenderPrinted',
          ],
        ],
      ],
      '',
    ];

    // Basic #markup based renderable array.
    $data[] = [
      [
        '#markup' => 'foo',
      ],
      'foo',
    ];

    // Basic #markup based renderable array with value '0'.
    $data[] = [
      [
        '#markup' => '0',
      ],
      '0',
    ];

    // Basic #markup based renderable array with value 0.
    $data[] = [
      [
        '#markup' => 0,
      ],
      '0',
    ];

    // Basic #markup based renderable array with value ''.
    $data[] = [
      [
        '#markup' => '',
      ],
      '',
    ];

    // Basic #markup based renderable array with value NULL.
    $data[] = [
      [
        '#markup' => NULL,
      ],
      '',
    ];

    // Basic #plain_text based renderable array.
    $data[] = [
      [
        '#plain_text' => 'foo',
      ],
      'foo',
    ];

    // Mixing #plain_text and #markup based renderable array.
    $data[] = [
      [
        '#plain_text' => '<em>foo</em>',
        '#markup' => 'bar',
      ],
      '&lt;em&gt;foo&lt;/em&gt;',
    ];

    // Safe strings in #plain_text are still escaped.
    $data[] = [
      [
        '#plain_text' => Markup::create('<em>foo</em>'),
      ],
      '&lt;em&gt;foo&lt;/em&gt;',
    ];

    // #plain_text based renderable array with value '0'.
    $data[] = [
      [
        '#plain_text' => '0',
      ],
      '0',
    ];

    // #plain_text based renderable array with value 0.
    $data[] = [
      [
        '#plain_text' => 0,
      ],
      '0',
    ];

    // #plain_text based renderable array with value ''.
    $data[] = [
      [
        '#plain_text' => '',
      ],
      '',
    ];

    // #plain_text based renderable array with value NULL.
    $data[] = [
      [
        '#plain_text' => NULL,
      ],
      '',
    ];

    // Renderable child element.
    $data[] = [
      [
        'child' => [
          '#markup' => 'bar',
        ],
      ],
      'bar',
    ];

    // XSS filtering test.
    $data[] = [
      [
        'child' => [
          '#markup' => "This is <script>alert('XSS')</script> test",
        ],
      ],
      "This is alert('XSS') test",
    ];

    // XSS filtering test.
    $data[] = [
      [
        'child' => [
          '#markup' => "This is <script>alert('XSS')</script> test",
          '#allowed_tags' => [
            'script',
          ],
        ],
      ],
      "This is <script>alert('XSS')</script> test",
    ];

    // XSS filtering test.
    $data[] = [
      [
        'child' => [
          '#markup' => "This is <script><em>alert('XSS')</em></script> <strong>test</strong>",
          '#allowed_tags' => [
            'em',
            'strong',
          ],
        ],
      ],
      "This is <em>alert('XSS')</em> <strong>test</strong>",
    ];

    // Html escaping test.
    $data[] = [
      [
        'child' => [
          '#plain_text' => "This is <script><em>alert('XSS')</em></script> <strong>test</strong>",
        ],
      ],
      "This is &lt;script&gt;&lt;em&gt;alert(&#039;XSS&#039;)&lt;/em&gt;&lt;/script&gt; &lt;strong&gt;test&lt;/strong&gt;",
    ];

    // XSS filtering by default test.
    $data[] = [
      [
        'child' => [
          '#markup' => "This is <script><em>alert('XSS')</em></script> <strong>test</strong>",
        ],
      ],
      "This is <em>alert('XSS')</em> <strong>test</strong>",
    ];

    // Ensure non-XSS tags are not filtered out.
    $data[] = [
      [
        'child' => [
          '#markup' => "This is <strong><script>alert('not a giraffe')</script></strong> test",
        ],
      ],
      "This is <strong>alert('not a giraffe')</strong> test",
    ];

    // #children set but empty, and renderable children.
    $data[] = [
      [
        '#children' => '',
        'child' => [
          '#markup' => 'bar',
        ],
      ],
      'bar',
    ];

    // #children set, not empty, and renderable children. #children will be
    // assumed oto be the rendered child elements, even though the #markup for
    // 'child' differs.
    $data[] = [
      [
        '#children' => 'foo',
        'child' => [
          '#markup' => 'bar',
        ],
      ],
      'foo',
    ];

    // Ensure that content added to #markup via a #pre_render callback is safe.
    $data[] = [
      [
        '#markup' => 'foo',
        '#pre_render' => [
          function ($elements) {
            $elements['#markup'] .= '<script>alert("bar");</script>';
            return $elements;
          },
        ],
      ],
      'fooalert("bar");',
    ];

    // Test #allowed_tags in combination with #markup and #pre_render.
    $data[] = [
      [
        '#markup' => 'foo',
        '#allowed_tags' => [
          'script',
        ],
        '#pre_render' => [
          function ($elements) {
            $elements['#markup'] .= '<script>alert("bar");</script>';
            return $elements;
          },
        ],
      ],
      'foo<script>alert("bar");</script>',
    ];

    // Ensure output is escaped when adding content to #check_plain through
    // a #pre_render callback.
    $data[] = [
      [
        '#plain_text' => 'foo',
        '#pre_render' => [
          function ($elements) {
            $elements['#plain_text'] .= '<script>alert("bar");</script>';
            return $elements;
          },
        ],
      ],
      'foo&lt;script&gt;alert(&quot;bar&quot;);&lt;/script&gt;',
    ];

    // Part 2: render arrays using #theme and #theme_wrappers.
    // Tests that #theme and #theme_wrappers can co-exist on an element.
    $build = [
      '#theme' => 'common_test_foo',
      '#foo' => 'foo',
      '#bar' => 'bar',
      '#theme_wrappers' => [
        'container',
      ],
      '#attributes' => [
        'class' => [
          'baz',
        ],
      ],
    ];
    $setup_code_type_link = function () {
      $this->themeManager
        ->expects($this
        ->exactly(2))
        ->method('render')
        ->with($this
        ->logicalOr('common_test_foo', 'container'))
        ->willReturnCallback(function ($theme, $vars) {
        if ($theme == 'container') {
          return '<div' . (string) new Attribute($vars['#attributes']) . '>' . $vars['#children'] . "</div>\n";
        }
        return $vars['#foo'] . $vars['#bar'];
      });
    };
    $data[] = [
      $build,
      '<div class="baz">foobar</div>' . "\n",
      $setup_code_type_link,
    ];

    // Tests that #theme_wrappers can disambiguate element attributes shared
    // with rendering methods that build #children by using the alternate
    // #theme_wrappers attribute override syntax.
    $build = [
      '#type' => 'link',
      '#theme_wrappers' => [
        'container' => [
          '#attributes' => [
            'class' => [
              'baz',
            ],
          ],
        ],
      ],
      '#attributes' => [
        'id' => 'foo',
      ],
      '#url' => 'https://www.drupal.org',
      '#title' => 'bar',
    ];
    $setup_code_type_link = function () {
      $this->themeManager
        ->expects($this
        ->exactly(2))
        ->method('render')
        ->with($this
        ->logicalOr('link', 'container'))
        ->willReturnCallback(function ($theme, $vars) {
        if ($theme == 'container') {
          return '<div' . (string) new Attribute($vars['#attributes']) . '>' . $vars['#children'] . "</div>\n";
        }
        $attributes = new Attribute([
          'href' => $vars['#url'],
        ] + (isset($vars['#attributes']) ? $vars['#attributes'] : []));
        return '<a' . (string) $attributes . '>' . $vars['#title'] . '</a>';
      });
    };
    $data[] = [
      $build,
      '<div class="baz"><a href="https://www.drupal.org" id="foo">bar</a></div>' . "\n",
      $setup_code_type_link,
    ];

    // Tests that #theme_wrappers can disambiguate element attributes when the
    // "base" attribute is not set for #theme.
    $build = [
      '#type' => 'link',
      '#url' => 'https://www.drupal.org',
      '#title' => 'foo',
      '#theme_wrappers' => [
        'container' => [
          '#attributes' => [
            'class' => [
              'baz',
            ],
          ],
        ],
      ],
    ];
    $data[] = [
      $build,
      '<div class="baz"><a href="https://www.drupal.org">foo</a></div>' . "\n",
      $setup_code_type_link,
    ];

    // Tests two 'container' #theme_wrappers, one using the "base" attributes
    // and one using an override.
    $build = [
      '#attributes' => [
        'class' => [
          'foo',
        ],
      ],
      '#theme_wrappers' => [
        'container' => [
          '#attributes' => [
            'class' => [
              'bar',
            ],
          ],
        ],
        'container',
      ],
    ];
    $setup_code = function () {
      $this->themeManager
        ->expects($this
        ->exactly(2))
        ->method('render')
        ->with('container')
        ->willReturnCallback(function ($theme, $vars) {
        return '<div' . (string) new Attribute($vars['#attributes']) . '>' . $vars['#children'] . "</div>\n";
      });
    };
    $data[] = [
      $build,
      '<div class="foo"><div class="bar"></div>' . "\n" . '</div>' . "\n",
      $setup_code,
    ];

    // Tests array syntax theme hook suggestion in #theme_wrappers.
    $build = [
      '#theme_wrappers' => [
        [
          'container',
        ],
      ],
      '#attributes' => [
        'class' => [
          'foo',
        ],
      ],
    ];
    $setup_code = function () {
      $this->themeManager
        ->expects($this
        ->once())
        ->method('render')
        ->with([
        'container',
      ])
        ->willReturnCallback(function ($theme, $vars) {
        return '<div' . (string) new Attribute($vars['#attributes']) . '>' . $vars['#children'] . "</div>\n";
      });
    };
    $data[] = [
      $build,
      '<div class="foo"></div>' . "\n",
      $setup_code,
    ];

    // Part 3: render arrays using #markup as a fallback for #theme hooks.
    // Theme suggestion is not implemented, #markup should be rendered.
    $build = [
      '#theme' => [
        'suggestionnotimplemented',
      ],
      '#markup' => 'foo',
    ];
    $setup_code = function () {
      $this->themeManager
        ->expects($this
        ->once())
        ->method('render')
        ->with([
        'suggestionnotimplemented',
      ], $this
        ->anything())
        ->willReturn(FALSE);
    };
    $data[] = [
      $build,
      'foo',
      $setup_code,
    ];

    // Tests unimplemented theme suggestion, child #markup should be rendered.
    $build = [
      '#theme' => [
        'suggestionnotimplemented',
      ],
      'child' => [
        '#markup' => 'foo',
      ],
    ];
    $setup_code = function () {
      $this->themeManager
        ->expects($this
        ->once())
        ->method('render')
        ->with([
        'suggestionnotimplemented',
      ], $this
        ->anything())
        ->willReturn(FALSE);
    };
    $data[] = [
      $build,
      'foo',
      $setup_code,
    ];

    // Tests implemented theme suggestion: #markup should not be rendered.
    $build = [
      '#theme' => [
        'common_test_empty',
      ],
      '#markup' => 'foo',
    ];
    $theme_function_output = $this
      ->randomContextValue();
    $setup_code = function () use ($theme_function_output) {
      $this->themeManager
        ->expects($this
        ->once())
        ->method('render')
        ->with([
        'common_test_empty',
      ], $this
        ->anything())
        ->willReturn($theme_function_output);
    };
    $data[] = [
      $build,
      $theme_function_output,
      $setup_code,
    ];

    // Tests implemented theme suggestion: children should not be rendered.
    $build = [
      '#theme' => [
        'common_test_empty',
      ],
      'child' => [
        '#markup' => 'foo',
      ],
    ];
    $data[] = [
      $build,
      $theme_function_output,
      $setup_code,
    ];

    // Part 4: handling of #children and child renderable elements.
    // #theme is implemented so the values of both #children and 'child' will
    // be ignored - it is the responsibility of the theme hook to render these
    // if appropriate.
    $build = [
      '#theme' => 'common_test_foo',
      '#children' => 'baz',
      'child' => [
        '#markup' => 'boo',
      ],
    ];
    $setup_code = function () {
      $this->themeManager
        ->expects($this
        ->once())
        ->method('render')
        ->with('common_test_foo', $this
        ->anything())
        ->willReturn('foobar');
    };
    $data[] = [
      $build,
      'foobar',
      $setup_code,
    ];

    // #theme is implemented but #render_children is TRUE. As in the case where
    // #theme is not set, empty #children means child elements are rendered
    // recursively.
    $build = [
      '#theme' => 'common_test_foo',
      '#children' => '',
      '#render_children' => TRUE,
      'child' => [
        '#markup' => 'boo',
      ],
    ];
    $setup_code = function () {
      $this->themeManager
        ->expects($this
        ->never())
        ->method('render');
    };
    $data[] = [
      $build,
      'boo',
      $setup_code,
    ];

    // #theme is implemented but #render_children is TRUE. As in the case where
    // #theme is not set, #children will take precedence over 'child'.
    $build = [
      '#theme' => 'common_test_foo',
      '#children' => 'baz',
      '#render_children' => TRUE,
      'child' => [
        '#markup' => 'boo',
      ],
    ];
    $setup_code = function () {
      $this->themeManager
        ->expects($this
        ->never())
        ->method('render');
    };
    $data[] = [
      $build,
      'baz',
      $setup_code,
    ];

    // #theme is implemented but #render_children is TRUE. In this case the
    // calling code is expecting only the children to be rendered. #prefix and
    // #suffix should not be inherited for the children.
    $build = [
      '#theme' => 'common_test_foo',
      '#children' => '',
      '#prefix' => 'kangaroo',
      '#suffix' => 'unicorn',
      '#render_children' => TRUE,
      'child' => [
        '#markup' => 'kitten',
      ],
    ];
    $setup_code = function () {
      $this->themeManager
        ->expects($this
        ->never())
        ->method('render');
    };
    $data[] = [
      $build,
      'kitten',
      $setup_code,
    ];
    return $data;
  }

  /**
   * @covers ::render
   * @covers ::doRender
   */
  public function testRenderSorting() {
    $first = $this
      ->randomMachineName();
    $second = $this
      ->randomMachineName();

    // Build an array with '#weight' set for each element.
    $elements = [
      'second' => [
        '#weight' => 10,
        '#markup' => $second,
      ],
      'first' => [
        '#weight' => 0,
        '#markup' => $first,
      ],
    ];
    $output = $this->renderer
      ->renderRoot($elements);

    // The lowest weight element should appear last in $output.
    $this
      ->assertGreaterThan(strpos($output, $first), strpos($output, $second));

    // Confirm that the $elements array has '#sorted' set to TRUE.
    $this
      ->assertTrue($elements['#sorted'], "'#sorted' => TRUE was added to the array");

    // Pass $elements through \Drupal\Core\Render\Element::children() and
    // ensure it remains sorted in the correct order. drupal_render() will
    // return an empty string if used on the same array in the same request.
    $children = Element::children($elements);
    $this
      ->assertSame('first', array_shift($children), 'Child found in the correct order.');
    $this
      ->assertSame('second', array_shift($children), 'Child found in the correct order.');
  }

  /**
   * @covers ::render
   * @covers ::doRender
   */
  public function testRenderSortingWithSetHashSorted() {
    $first = $this
      ->randomMachineName();
    $second = $this
      ->randomMachineName();

    // The same array structure again, but with #sorted set to TRUE.
    $elements = [
      'second' => [
        '#weight' => 10,
        '#markup' => $second,
      ],
      'first' => [
        '#weight' => 0,
        '#markup' => $first,
      ],
      '#sorted' => TRUE,
    ];
    $output = $this->renderer
      ->renderRoot($elements);

    // The elements should appear in output in the same order as the array.
    $this
      ->assertLessThan(strpos($output, $first), strpos($output, $second));
  }

  /**
   * @covers ::render
   * @covers ::doRender
   *
   * @dataProvider providerAccessValues
   */
  public function testRenderWithPresetAccess($access) {
    $build = [
      '#access' => $access,
    ];
    $this
      ->assertAccess($build, $access);
  }

  /**
   * @covers ::render
   * @covers ::doRender
   *
   * @dataProvider providerAccessValues
   */
  public function testRenderWithAccessCallbackCallable($access) {
    $build = [
      '#access_callback' => function () use ($access) {
        return $access;
      },
    ];
    $this
      ->assertAccess($build, $access);
  }

  /**
   * Ensures that the #access property wins over the callable.
   *
   * @covers ::render
   * @covers ::doRender
   *
   * @dataProvider providerAccessValues
   */
  public function testRenderWithAccessPropertyAndCallback($access) {
    $build = [
      '#access' => $access,
      '#access_callback' => function () {
        return TRUE;
      },
    ];
    $this
      ->assertAccess($build, $access);
  }

  /**
   * @covers ::render
   * @covers ::doRender
   *
   * @dataProvider providerAccessValues
   */
  public function testRenderWithAccessControllerResolved($access) {
    switch ($access) {
      case AccessResult::allowed():
        $method = 'accessResultAllowed';
        break;
      case AccessResult::forbidden():
        $method = 'accessResultForbidden';
        break;
      case FALSE:
        $method = 'accessFalse';
        break;
      case TRUE:
        $method = 'accessTrue';
        break;
    }
    $build = [
      '#access_callback' => 'Drupal\\Tests\\Core\\Render\\TestAccessClass::' . $method,
    ];
    $this
      ->assertAccess($build, $access);
  }

  /**
   * @covers ::render
   * @covers ::doRender
   */
  public function testRenderAccessCacheabilityDependencyInheritance() {
    $build = [
      '#access' => AccessResult::allowed()
        ->addCacheContexts([
        'user',
      ]),
    ];
    $this->renderer
      ->renderPlain($build);
    $this
      ->assertEqualsCanonicalizing([
      'languages:language_interface',
      'theme',
      'user',
    ], $build['#cache']['contexts']);
  }

  /**
   * Tests rendering same render array twice.
   *
   * Tests that a first render returns the rendered output and a second doesn't
   * because of the #printed property. Also tests that correct metadata has been
   * set for re-rendering.
   *
   * @covers ::render
   * @covers ::doRender
   *
   * @dataProvider providerRenderTwice
   */
  public function testRenderTwice($build) {
    $this
      ->assertEquals('kittens', $this->renderer
      ->renderRoot($build));
    $this
      ->assertEquals('kittens', $build['#markup']);
    $this
      ->assertEquals([
      'kittens-147',
    ], $build['#cache']['tags']);
    $this
      ->assertTrue($build['#printed']);

    // We don't want to reprint already printed render arrays.
    $this
      ->assertEquals('', $this->renderer
      ->renderRoot($build));
  }

  /**
   * Provides a list of render array iterations.
   *
   * @return array
   */
  public function providerRenderTwice() {
    return [
      [
        [
          '#markup' => 'kittens',
          '#cache' => [
            'tags' => [
              'kittens-147',
            ],
          ],
        ],
      ],
      [
        [
          'child' => [
            '#markup' => 'kittens',
            '#cache' => [
              'tags' => [
                'kittens-147',
              ],
            ],
          ],
        ],
      ],
      [
        [
          '#render_children' => TRUE,
          'child' => [
            '#markup' => 'kittens',
            '#cache' => [
              'tags' => [
                'kittens-147',
              ],
            ],
          ],
        ],
      ],
    ];
  }

  /**
   * Ensures that #access is taken in account when rendering #render_children.
   */
  public function testRenderChildrenAccess() {
    $build = [
      '#access' => FALSE,
      '#render_children' => TRUE,
      'child' => [
        '#markup' => 'kittens',
      ],
    ];
    $this
      ->assertEquals('', $this->renderer
      ->renderRoot($build));
  }

  /**
   * Provides a list of both booleans.
   *
   * @return array
   */
  public function providerAccessValues() {
    return [
      [
        FALSE,
      ],
      [
        TRUE,
      ],
      [
        AccessResult::forbidden(),
      ],
      [
        AccessResult::allowed(),
      ],
    ];
  }

  /**
   * Asserts that a render array with access checking renders correctly.
   *
   * @param array $build
   *   A render array with either #access or #access_callback.
   * @param bool $access
   *   Whether the render array is accessible or not.
   */
  protected function assertAccess($build, $access) {
    $sensitive_content = $this
      ->randomContextValue();
    $build['#markup'] = $sensitive_content;
    if ($access instanceof AccessResultInterface && $access
      ->isAllowed() || $access === TRUE) {
      $this
        ->assertSame($sensitive_content, (string) $this->renderer
        ->renderRoot($build));
    }
    else {
      $this
        ->assertSame('', (string) $this->renderer
        ->renderRoot($build));
    }
  }

  /**
   * @covers ::render
   * @covers ::doRender
   */
  public function testRenderWithoutThemeArguments() {
    $element = [
      '#theme' => 'common_test_foo',
    ];
    $this->themeManager
      ->expects($this
      ->once())
      ->method('render')
      ->with('common_test_foo', $this->defaultThemeVars + $element)
      ->willReturn('foobar');

    // Test that defaults work.
    $this
      ->assertEquals('foobar', $this->renderer
      ->renderRoot($element), 'Defaults work');
  }

  /**
   * @covers ::render
   * @covers ::doRender
   */
  public function testRenderWithThemeArguments() {
    $element = [
      '#theme' => 'common_test_foo',
      '#foo' => $this
        ->randomMachineName(),
      '#bar' => $this
        ->randomMachineName(),
    ];
    $this->themeManager
      ->expects($this
      ->once())
      ->method('render')
      ->with('common_test_foo', $this->defaultThemeVars + $element)
      ->willReturnCallback(function ($hook, $vars) {
      return $vars['#foo'] . $vars['#bar'];
    });

    // Tests that passing arguments to the theme function works.
    $this
      ->assertEquals($this->renderer
      ->renderRoot($element), $element['#foo'] . $element['#bar'], 'Passing arguments to theme functions works');
  }

  /**
   * @covers ::render
   * @covers ::doRender
   * @covers \Drupal\Core\Render\RenderCache::get
   * @covers \Drupal\Core\Render\RenderCache::set
   * @covers \Drupal\Core\Render\RenderCache::createCacheID
   */
  public function testRenderCache() {
    $this
      ->setUpRequest();
    $this
      ->setupMemoryCache();

    // Create an empty element.
    $test_element = [
      '#cache' => [
        'keys' => [
          'render_cache_test',
        ],
        'tags' => [
          'render_cache_tag',
        ],
      ],
      '#markup' => '',
      'child' => [
        '#cache' => [
          'keys' => [
            'render_cache_test_child',
          ],
          'tags' => [
            'render_cache_tag_child:1',
            'render_cache_tag_child:2',
          ],
        ],
        '#markup' => '',
      ],
    ];

    // Render the element and confirm that it goes through the rendering
    // process (which will set $element['#printed']).
    $element = $test_element;
    $this->renderer
      ->renderRoot($element);
    $this
      ->assertTrue(isset($element['#printed']), 'No cache hit');

    // Render the element again and confirm that it is retrieved from the cache
    // instead (so $element['#printed'] will not be set).
    $element = $test_element;
    $this->renderer
      ->renderRoot($element);
    $this
      ->assertFalse(isset($element['#printed']), 'Cache hit');

    // Test that cache tags are correctly collected from the render element,
    // including the ones from its subchild.
    $expected_tags = [
      'render_cache_tag',
      'render_cache_tag_child:1',
      'render_cache_tag_child:2',
    ];
    $this
      ->assertEquals($expected_tags, $element['#cache']['tags'], 'Cache tags were collected from the element and its subchild.');

    // The cache item also has a 'rendered' cache tag.
    $cache_item = $this->cacheFactory
      ->get('render')
      ->get('render_cache_test:en:stark');
    $this
      ->assertSame(Cache::mergeTags($expected_tags, [
      'rendered',
    ]), $cache_item->tags);
  }

  /**
   * @covers ::render
   * @covers ::doRender
   * @covers \Drupal\Core\Render\RenderCache::get
   * @covers \Drupal\Core\Render\RenderCache::set
   * @covers \Drupal\Core\Render\RenderCache::createCacheID
   *
   * @dataProvider providerTestRenderCacheMaxAge
   */
  public function testRenderCacheMaxAge($max_age, $is_render_cached, $render_cache_item_expire) {
    $this
      ->setUpRequest();
    $this
      ->setupMemoryCache();
    $element = [
      '#cache' => [
        'keys' => [
          'render_cache_test',
        ],
        'max-age' => $max_age,
      ],
      '#markup' => '',
    ];
    $this->renderer
      ->renderRoot($element);
    $cache_item = $this->cacheFactory
      ->get('render')
      ->get('render_cache_test:en:stark');
    if (!$is_render_cached) {
      $this
        ->assertFalse($cache_item);
    }
    else {
      $this
        ->assertNotFalse($cache_item);
      $this
        ->assertSame($render_cache_item_expire, $cache_item->expire);
    }
  }
  public function providerTestRenderCacheMaxAge() {
    return [
      [
        0,
        FALSE,
        NULL,
      ],
      [
        60,
        TRUE,
        (int) $_SERVER['REQUEST_TIME'] + 60,
      ],
      [
        Cache::PERMANENT,
        TRUE,
        -1,
      ],
    ];
  }

  /**
   * Tests that #cache_properties are properly handled.
   *
   * @param array $expected_results
   *   An associative array of expected results keyed by property name.
   *
   * @covers ::render
   * @covers ::doRender
   * @covers \Drupal\Core\Render\RenderCache::get
   * @covers \Drupal\Core\Render\RenderCache::set
   * @covers \Drupal\Core\Render\RenderCache::createCacheID
   * @covers \Drupal\Core\Render\RenderCache::getCacheableRenderArray
   *
   * @dataProvider providerTestRenderCacheProperties
   */
  public function testRenderCacheProperties(array $expected_results) {
    $this
      ->setUpRequest();
    $this
      ->setupMemoryCache();
    $element = $original = [
      '#cache' => [
        'keys' => [
          'render_cache_test',
        ],
      ],
      // Collect expected property names.
      '#cache_properties' => array_keys(array_filter($expected_results)),
      'child1' => [
        '#markup' => Markup::create('1'),
      ],
      'child2' => [
        '#markup' => Markup::create('2'),
      ],
      // Mark the value as safe.
      '#custom_property' => Markup::create('custom_value'),
      '#custom_property_array' => [
        'custom value',
      ],
    ];
    $this->renderer
      ->renderRoot($element);
    $cache = $this->cacheFactory
      ->get('render');
    $data = $cache
      ->get('render_cache_test:en:stark')->data;

    // Check that parent markup is ignored when caching children's markup.
    $this
      ->assertEquals($data['#markup'] === '', (bool) Element::children($data));

    // Check that the element properties are cached as specified.
    foreach ($expected_results as $property => $expected) {
      $cached = !empty($data[$property]);
      $this
        ->assertEquals($cached, (bool) $expected);

      // Check that only the #markup key is preserved for children.
      if ($cached) {
        $this
          ->assertEquals($data[$property], $original[$property]);
      }
    }

    // #custom_property_array can not be a safe_cache_property.
    $safe_cache_properties = array_diff(Element::properties(array_filter($expected_results)), [
      '#custom_property_array',
    ]);
    foreach ($safe_cache_properties as $cache_property) {
      $this
        ->assertInstanceOf(MarkupInterface::class, $data[$cache_property]);
    }
  }

  /**
   * Data provider for ::testRenderCacheProperties().
   *
   * @return array
   *   An array of associative arrays of expected results keyed by property
   *   name.
   */
  public function providerTestRenderCacheProperties() {
    return [
      [
        [],
      ],
      [
        [
          'child1' => 0,
          'child2' => 0,
          '#custom_property' => 0,
          '#custom_property_array' => 0,
        ],
      ],
      [
        [
          'child1' => 0,
          'child2' => 0,
          '#custom_property' => 1,
          '#custom_property_array' => 0,
        ],
      ],
      [
        [
          'child1' => 0,
          'child2' => 1,
          '#custom_property' => 0,
          '#custom_property_array' => 0,
        ],
      ],
      [
        [
          'child1' => 0,
          'child2' => 1,
          '#custom_property' => 1,
          '#custom_property_array' => 0,
        ],
      ],
      [
        [
          'child1' => 1,
          'child2' => 0,
          '#custom_property' => 0,
          '#custom_property_array' => 0,
        ],
      ],
      [
        [
          'child1' => 1,
          'child2' => 0,
          '#custom_property' => 1,
          '#custom_property_array' => 0,
        ],
      ],
      [
        [
          'child1' => 1,
          'child2' => 1,
          '#custom_property' => 0,
          '#custom_property_array' => 0,
        ],
      ],
      [
        [
          'child1' => 1,
          'child2' => 1,
          '#custom_property' => 1,
          '#custom_property_array' => 0,
        ],
      ],
      [
        [
          'child1' => 1,
          'child2' => 1,
          '#custom_property' => 1,
          '#custom_property_array' => 1,
        ],
      ],
    ];
  }

  /**
   * @covers ::addCacheableDependency
   *
   * @dataProvider providerTestAddCacheableDependency
   */
  public function testAddCacheableDependency(array $build, $object, array $expected) {
    $this->renderer
      ->addCacheableDependency($build, $object);
    $this
      ->assertEquals($build, $expected);
  }
  public function providerTestAddCacheableDependency() {
    return [
      // Empty render array, typical default cacheability.
      [
        [],
        new TestCacheableDependency([], [], Cache::PERMANENT),
        [
          '#cache' => [
            'contexts' => [],
            'tags' => [],
            'max-age' => Cache::PERMANENT,
          ],
        ],
      ],
      // Empty render array, some cacheability.
      [
        [],
        new TestCacheableDependency([
          'user.roles',
        ], [
          'foo',
        ], Cache::PERMANENT),
        [
          '#cache' => [
            'contexts' => [
              'user.roles',
            ],
            'tags' => [
              'foo',
            ],
            'max-age' => Cache::PERMANENT,
          ],
        ],
      ],
      // Cacheable render array, some cacheability.
      [
        [
          '#cache' => [
            'contexts' => [
              'theme',
            ],
            'tags' => [
              'bar',
            ],
            'max-age' => 600,
          ],
        ],
        new TestCacheableDependency([
          'user.roles',
        ], [
          'foo',
        ], Cache::PERMANENT),
        [
          '#cache' => [
            'contexts' => [
              'theme',
              'user.roles',
            ],
            'tags' => [
              'bar',
              'foo',
            ],
            'max-age' => 600,
          ],
        ],
      ],
      // Cacheable render array, no cacheability.
      [
        [
          '#cache' => [
            'contexts' => [
              'theme',
            ],
            'tags' => [
              'bar',
            ],
            'max-age' => 600,
          ],
        ],
        new \stdClass(),
        [
          '#cache' => [
            'contexts' => [
              'theme',
            ],
            'tags' => [
              'bar',
            ],
            'max-age' => 0,
          ],
        ],
      ],
    ];
  }

}

Members

Name	Modifiers	Type	Description	Overrides
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.
RendererTest::$defaultThemeVars	protected	property
RendererTest::assertAccess	protected	function	Asserts that a render array with access checking renders correctly.
RendererTest::providerAccessValues	public	function	Provides a list of both booleans.
RendererTest::providerRenderTwice	public	function	Provides a list of render array iterations.
RendererTest::providerTestAddCacheableDependency	public	function
RendererTest::providerTestRenderBasic	public	function	Provides a list of render arrays to test basic rendering.
RendererTest::providerTestRenderCacheMaxAge	public	function
RendererTest::providerTestRenderCacheProperties	public	function	Data provider for ::testRenderCacheProperties().
RendererTest::testAddCacheableDependency	public	function	@covers ::addCacheableDependency
RendererTest::testRenderAccessCacheabilityDependencyInheritance	public	function	@covers ::render @covers ::doRender
RendererTest::testRenderBasic	public	function	@covers ::render @covers ::doRender
RendererTest::testRenderCache	public	function	@covers ::render @covers ::doRender @covers \Drupal\Core\Render\RenderCache::get @covers \Drupal\Core\Render\RenderCache::set @covers \Drupal\Core\Render\RenderCache::createCacheID
RendererTest::testRenderCacheMaxAge	public	function	@covers ::render @covers ::doRender @covers \Drupal\Core\Render\RenderCache::get @covers \Drupal\Core\Render\RenderCache::set @covers \Drupal\Core\Render\RenderCache::createCacheID
RendererTest::testRenderCacheProperties	public	function	Tests that #cache_properties are properly handled.
RendererTest::testRenderChildrenAccess	public	function	Ensures that #access is taken in account when rendering #render_children.
RendererTest::testRenderSorting	public	function	@covers ::render @covers ::doRender
RendererTest::testRenderSortingWithSetHashSorted	public	function	@covers ::render @covers ::doRender
RendererTest::testRenderTwice	public	function	Tests rendering same render array twice.
RendererTest::testRenderWithAccessCallbackCallable	public	function	@covers ::render @covers ::doRender
RendererTest::testRenderWithAccessControllerResolved	public	function	@covers ::render @covers ::doRender
RendererTest::testRenderWithAccessPropertyAndCallback	public	function	Ensures that the #access property wins over the callable.
RendererTest::testRenderWithoutThemeArguments	public	function	@covers ::render @covers ::doRender
RendererTest::testRenderWithPresetAccess	public	function	@covers ::render @covers ::doRender
RendererTest::testRenderWithThemeArguments	public	function	@covers ::render @covers ::doRender
RendererTestBase::$cacheContexts	protected	property
RendererTestBase::$cacheFactory	protected	property
RendererTestBase::$controllerResolver	protected	property	The mocked controller resolver.
RendererTestBase::$currentUserRole	protected	property	The simulated "current" user role, for use in tests with cache contexts.
RendererTestBase::$elementInfo	protected	property	The mocked element info.
RendererTestBase::$memoryCache	protected	property
RendererTestBase::$placeholderGenerator	protected	property	The tested placeholder generator.	1
RendererTestBase::$renderCache	protected	property	The tested render cache.
RendererTestBase::$renderer	protected	property	The tested renderer.
RendererTestBase::$rendererConfig	protected	property	The mocked renderer configuration.
RendererTestBase::$requestStack	protected	property
RendererTestBase::$themeManager	protected	property	The mocked theme manager.
RendererTestBase::assertRenderCacheItem	protected	function	Asserts a render cache item.
RendererTestBase::randomContextValue	protected	function	Generates a random context value for the placeholder tests.
RendererTestBase::setUp	protected	function	Overrides UnitTestCase::setUp	3
RendererTestBase::setupMemoryCache	protected	function	Sets up a memory-based render cache back-end.
RendererTestBase::setUpRequest	protected	function	Sets up a request object on the request stack.
RendererTestBase::setUpUnusedCache	protected	function	Sets up a render cache back-end that is asserted to be never used.
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::setUpBeforeClass	public static	function