ViewsHooksTest.php

Same filename in other branches
  1. 9 core/modules/views/tests/src/Kernel/ViewsHooksTest.php
  2. 8.9.x core/modules/views/tests/src/Kernel/ViewsHooksTest.php
  3. 11.x core/modules/views/tests/src/Kernel/ViewsHooksTest.php

Namespace

Drupal\Tests\views\Kernel

File

core/modules/views/tests/src/Kernel/ViewsHooksTest.php

View source
<?php

declare (strict_types=1);
namespace Drupal\Tests\views\Kernel;

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()
 */
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;
    
    /**
     * The view storage.
     *
     * @var \Drupal\Core\Entity\EntityStorageInterface
     */
    protected $viewStorage;
    
    /**
     * {@inheritdoc}
     */
    protected function setUp($import_test_views = TRUE) : void {
        parent::setUp();
        $this->moduleHandler = $this->container
            ->get('module_handler');
        $this->viewStorage = $this->container
            ->get('entity_type.manager')
            ->getStorage('view');
    }
    
    /**
     * Tests the hooks.
     */
    public function testHooks() : void {
        $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
                ->hasImplementations($hook, 'views_test_data'), "The hook {$hook} was registered.");
            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
                        ->alter($hook, $data);
                    break;
                default:
                    $this->moduleHandler
                        ->invoke('views_test_data', $hook);
            }
            $this->assertTrue($this->container
                ->get('state')
                ->get('views_hook_test_' . $hook), "The {$hook} hook was invoked.");
            // 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() : void {
        $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>');
    }
    
    /**
     * Test that hook_views_invalidate_cache() is called when a view is deleted.
     */
    public function testViewsInvalidateCacheOnDelete() : void {
        $this->container
            ->get('state')
            ->set('views_hook_test_views_invalidate_cache', FALSE);
        $view = $this->viewStorage
            ->load('test_view');
        $view->delete();
        $this->assertTrue($this->container
            ->get('state')
            ->get('views_hook_test_views_invalidate_cache'));
    }

}

Classes

Title Deprecated Summary
ViewsHooksTest Tests that views hooks are registered when defined in $module.views.inc.

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