ViewsHooksTest.php

<?php

namespace Drupal\Tests\views\Kernel;

use Drupal\Component\Render\FormattableMarkup;
use Drupal\Core\Render\RenderContext;
use Drupal\views\Form\ViewsFormMainForm;
use Drupal\views\Views;

/**
 * Tests that views hooks are registered when defined in $module.views.inc.
 *
 * @group views
 * @see views_hook_info().
 * @see field_hook_info().
 */
class ViewsHooksTest extends ViewsKernelTestBase {
    
    /**
     * Views used by this test.
     *
     * @var array
     */
    public static $testViews = [
        'test_view',
    ];
    
    /**
     * An array of available views hooks to test.
     *
     * @var array
     */
    protected static $hooks = [
        'views_data' => 'all',
        'views_data_alter' => 'alter',
        'views_query_substitutions' => 'view',
        'views_form_substitutions' => 'view',
        'views_analyze' => 'view',
        'views_pre_view' => 'view',
        'views_pre_build' => 'view',
        'views_post_build' => 'view',
        'views_pre_execute' => 'view',
        'views_post_execute' => 'view',
        'views_pre_render' => 'view',
        'views_post_render' => 'view',
        'views_query_alter' => 'view',
        'views_invalidate_cache' => 'all',
    ];
    
    /**
     * The module handler to use for invoking hooks.
     *
     * @var \Drupal\Core\Extension\ModuleHandlerInterface
     */
    protected $moduleHandler;
    protected function setUp($import_test_views = TRUE) {
        parent::setUp();
        $this->moduleHandler = $this->container
            ->get('module_handler');
    }
    
    /**
     * Tests the hooks.
     */
    public function testHooks() {
        $view = Views::getView('test_view');
        $view->setDisplay();
        // Test each hook is found in the implementations array and is invoked.
        foreach (static::$hooks as $hook => $type) {
            $this->assertTrue($this->moduleHandler
                ->implementsHook('views_test_data', $hook), new FormattableMarkup('The hook @hook was registered.', [
                '@hook' => $hook,
            ]));
            if ($hook == 'views_post_render') {
                $this->moduleHandler
                    ->invoke('views_test_data', $hook, [
                    $view,
                    &$view->display_handler->output,
                    $view->display_handler
                        ->getPlugin('cache'),
                ]);
                continue;
            }
            switch ($type) {
                case 'view':
                    $this->moduleHandler
                        ->invoke('views_test_data', $hook, [
                        $view,
                    ]);
                    break;
                case 'alter':
                    $data = [];
                    $this->moduleHandler
                        ->invoke('views_test_data', $hook, [
                        $data,
                    ]);
                    break;
                default:
                    $this->moduleHandler
                        ->invoke('views_test_data', $hook);
            }
            $this->assertTrue($this->container
                ->get('state')
                ->get('views_hook_test_' . $hook), new FormattableMarkup('The %hook hook was invoked.', [
                '%hook' => $hook,
            ]));
            // Reset the module implementations cache, so we ensure that the
            // .views.inc file is loaded actively.
            $this->moduleHandler
                ->resetImplementations();
        }
    }
    
    /**
     * Tests how hook_views_form_substitutions() makes substitutions.
     *
     * @see views_test_data_views_form_substitutions()
     * @see \Drupal\views\Form\ViewsFormMainForm::preRenderViewsForm()
     */
    public function testViewsFormMainFormPreRender() {
        $element = [
            'output' => [
                '#plain_text' => '<!--will-be-escaped--><!--will-be-not-escaped-->',
            ],
            '#substitutions' => [
                '#value' => [],
            ],
        ];
        $element = \Drupal::service('renderer')->executeInRenderContext(new RenderContext(), function () use ($element) {
            return ViewsFormMainForm::preRenderViewsForm($element);
        });
        $this->setRawContent((string) $element['output']['#markup']);
        $this->assertEscaped('<em>escaped</em>');
        $this->assertRaw('<em>unescaped</em>');
    }
    
    /**
     * Tests views_pre_render_views_form_views_form() deprecation.
     *
     * @group legacy
     *
     * @expectedDeprecation views_pre_render_views_form_views_form() is deprecated in Drupal 8.8.0 and will be removed before Drupal 9.0.0. Use \Drupal\views\Form\ViewsFormMainForm::preRenderViewsForm() instead. See https://www.drupal.org/node/2966725
     */
    public function testViewsPreRenderViewsFormViewsForm() {
        $element = [
            'output' => [
                '#plain_text' => '<!--will-be-escaped--><!--will-be-not-escaped-->',
            ],
            '#substitutions' => [
                '#value' => [],
            ],
        ];
        $element = \Drupal::service('renderer')->executeInRenderContext(new RenderContext(), function () use ($element) {
            return views_pre_render_views_form_views_form($element);
        });
        $this->setRawContent((string) $element['output']['#markup']);
        $this->assertEscaped('<em>escaped</em>');
        $this->assertRaw('<em>unescaped</em>');
    }

}