FilterFormTest.php

<?php

declare (strict_types=1);
namespace Drupal\Tests\filter\Functional;

use Drupal\filter\Entity\FilterFormat;
use Drupal\Tests\BrowserTestBase;

/**
 * Tests form elements with associated text formats.
 *
 * @group filter
 */
class FilterFormTest extends BrowserTestBase {
    
    /**
     * {@inheritdoc}
     */
    protected static $modules = [
        'filter',
        'filter_test',
    ];
    
    /**
     * {@inheritdoc}
     */
    protected $defaultTheme = 'stark';
    
    /**
     * An administrative user account that can administer text formats.
     *
     * @var \Drupal\user\Entity\User
     */
    protected $adminUser;
    
    /**
     * A basic user account that can only access basic HTML text format.
     *
     * @var \Drupal\user\Entity\User
     */
    protected $webUser;
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() : void {
        parent::setUp();
        
        /** @var \Drupal\filter\FilterFormatInterface $filter_test_format */
        $filter_test_format = FilterFormat::load('filter_test');
        
        /** @var \Drupal\filter\FilterFormatInterface $filtered_html_format */
        $filtered_html_format = FilterFormat::load('filtered_html');
        
        /** @var \Drupal\filter\FilterFormatInterface $full_html_format */
        $full_html_format = FilterFormat::load('full_html');
        // Create users.
        $this->adminUser = $this->drupalCreateUser([
            'administer filters',
            $filtered_html_format->getPermissionName(),
            $full_html_format->getPermissionName(),
            $filter_test_format->getPermissionName(),
        ]);
        $this->webUser = $this->drupalCreateUser([
            $filtered_html_format->getPermissionName(),
            $filter_test_format->getPermissionName(),
        ]);
    }
    
    /**
     * Tests various different configurations of the 'text_format' element.
     */
    public function testFilterForm() : void {
        $this->doFilterFormTestAsAdmin();
        $this->doFilterFormTestAsNonAdmin();
        // Ensure that enabling modules which provide filter plugins behaves
        // correctly.
        // @see https://www.drupal.org/node/2387983
        \Drupal::service('module_installer')->install([
            'filter_test_plugin',
        ]);
    }
    
    /**
     * Tests the behavior of the 'text_format' element as an administrator.
     */
    protected function doFilterFormTestAsAdmin() {
        $this->drupalLogin($this->adminUser);
        $this->drupalGet('filter-test/text-format');
        // Test a text format element with all formats.
        $formats = [
            'filtered_html',
            'full_html',
            'filter_test',
        ];
        $this->assertEnabledTextarea('edit-all-formats-no-default-value');
        // If no default is given, the format with the lowest weight becomes the
        // default.
        $this->assertOptions('edit-all-formats-no-default-format--2', $formats, 'filtered_html');
        $this->assertEnabledTextarea('edit-all-formats-default-value');
        // \Drupal\filter_test\Form\FilterTestFormatForm::buildForm() uses
        // 'filter_test' as the default value in this case.
        $this->assertOptions('edit-all-formats-default-format--2', $formats, 'filter_test');
        $this->assertEnabledTextarea('edit-all-formats-default-missing-value');
        // If a missing format is set as the default, administrators must select a
        // valid replacement format.
        $this->assertRequiredSelectAndOptions('edit-all-formats-default-missing-format--2', $formats);
        // Test a text format element with a predefined list of formats.
        $formats = [
            'full_html',
            'filter_test',
        ];
        $this->assertEnabledTextarea('edit-restricted-formats-no-default-value');
        $this->assertOptions('edit-restricted-formats-no-default-format--2', $formats, 'full_html');
        $this->assertEnabledTextarea('edit-restricted-formats-default-value');
        $this->assertOptions('edit-restricted-formats-default-format--2', $formats, 'full_html');
        $this->assertEnabledTextarea('edit-restricted-formats-default-missing-value');
        $this->assertRequiredSelectAndOptions('edit-restricted-formats-default-missing-format--2', $formats);
        $this->assertEnabledTextarea('edit-restricted-formats-default-disallowed-value');
        $this->assertRequiredSelectAndOptions('edit-restricted-formats-default-disallowed-format--2', $formats);
        // Test a text format element with a fixed format.
        $formats = [
            'filter_test',
        ];
        // When there is only a single option there is no point in choosing.
        $this->assertEnabledTextarea('edit-single-format-no-default-value');
        $this->assertNoSelect('edit-single-format-no-default-format--2');
        $this->assertEnabledTextarea('edit-single-format-default-value');
        $this->assertNoSelect('edit-single-format-default-format--2');
        // If the select has a missing or disallowed format, administrators must
        // explicitly choose the format.
        $this->assertEnabledTextarea('edit-single-format-default-missing-value');
        $this->assertRequiredSelectAndOptions('edit-single-format-default-missing-format--2', $formats);
        $this->assertEnabledTextarea('edit-single-format-default-disallowed-value');
        $this->assertRequiredSelectAndOptions('edit-single-format-default-disallowed-format--2', $formats);
    }
    
    /**
     * Tests the behavior of the 'text_format' element as a normal user.
     */
    protected function doFilterFormTestAsNonAdmin() {
        $this->drupalLogin($this->webUser);
        $this->drupalGet('filter-test/text-format');
        // Test a text format element with all formats. Only formats the user has
        // access to are shown.
        $formats = [
            'filtered_html',
            'filter_test',
        ];
        $this->assertEnabledTextarea('edit-all-formats-no-default-value');
        // If no default is given, the format with the lowest weight becomes the
        // default. This happens to be 'filtered_html'.
        $this->assertOptions('edit-all-formats-no-default-format--2', $formats, 'filtered_html');
        $this->assertEnabledTextarea('edit-all-formats-default-value');
        // \Drupal\filter_test\Form\FilterTestFormatForm::buildForm() uses
        // 'filter_test' as the default value in this case.
        $this->assertOptions('edit-all-formats-default-format--2', $formats, 'filter_test');
        // If a missing format is given as default, non-admin users are presented
        // with a disabled textarea.
        $this->assertDisabledTextarea('edit-all-formats-default-missing-value');
        // Test a text format element with a predefined list of formats.
        $this->assertEnabledTextarea('edit-restricted-formats-no-default-value');
        // The user only has access to the 'filter_test' format, so when no default
        // is given that is preselected and the text format select is hidden.
        $this->assertNoSelect('edit-restricted-formats-no-default-format--2');
        // When the format that the user does not have access to is preselected, the
        // textarea should be disabled.
        $this->assertDisabledTextarea('edit-restricted-formats-default-value');
        $this->assertDisabledTextarea('edit-restricted-formats-default-missing-value');
        $this->assertDisabledTextarea('edit-restricted-formats-default-disallowed-value');
        // Test a text format element with a fixed format.
        // When there is only a single option there is no point in choosing.
        $this->assertEnabledTextarea('edit-single-format-no-default-value');
        $this->assertNoSelect('edit-single-format-no-default-format--2');
        $this->assertEnabledTextarea('edit-single-format-default-value');
        $this->assertNoSelect('edit-single-format-default-format--2');
        // If the select has a missing or disallowed format make sure the textarea
        // is disabled.
        $this->assertDisabledTextarea('edit-single-format-default-missing-value');
        $this->assertDisabledTextarea('edit-single-format-default-disallowed-value');
    }
    
    /**
     * Makes sure that no select element with the given ID exists on the page.
     *
     * @param string $id
     *   The HTML ID of the select element.
     *
     * @internal
     */
    protected function assertNoSelect(string $id) : void {
        $this->assertSession()
            ->elementNotExists('xpath', "//select[@id={$id}]");
    }
    
    /**
     * Asserts that a select element has the correct options.
     *
     * @param string $id
     *   The HTML ID of the select element.
     * @param array $expected_options
     *   An array of option values.
     * @param string $selected
     *   The value of the selected option.
     *
     * @internal
     */
    protected function assertOptions(string $id, array $expected_options, string $selected) : void {
        $select = $this->assertSession()
            ->selectExists($id);
        $found_options = $select->findAll('css', 'option');
        $found_options = array_map(function ($item) {
            return $item->getValue();
        }, $found_options);
        $this->assertEqualsCanonicalizing($expected_options, $found_options);
        $this->assertTrue($this->assertSession()
            ->optionExists($id, $selected)
            ->isSelected());
    }
    
    /**
     * Asserts that there is a select element with the given ID that is required.
     *
     * @param string $id
     *   The HTML ID of the select element.
     * @param array $options
     *   An array of option values that are contained in the select element
     *   besides the "- Select -" option.
     *
     * @internal
     */
    protected function assertRequiredSelectAndOptions(string $id, array $options) : void {
        $select = $this->assertSession()
            ->selectExists($id);
        $this->assertSame('required', $select->getAttribute('required'));
        // A required select element has a "- Select -" option whose key is an empty
        // string.
        $options[] = '';
        $this->assertOptions($id, $options, '');
    }
    
    /**
     * Asserts that a textarea with a given ID exists and is not disabled.
     *
     * @param string $id
     *   The HTML ID of the textarea.
     *
     * @internal
     */
    protected function assertEnabledTextarea(string $id) : void {
        $textarea = $this->assertSession()
            ->fieldEnabled($id);
        $this->assertSame('textarea', $textarea->getTagName());
    }
    
    /**
     * Asserts that a textarea with a given ID has been disabled from editing.
     *
     * @param string $id
     *   The HTML ID of the textarea.
     *
     * @internal
     */
    protected function assertDisabledTextarea(string $id) : void {
        $textarea = $this->assertSession()
            ->fieldDisabled($id);
        $this->assertSame('textarea', $textarea->getTagName());
        $this->assertSame('This field has been disabled because you do not have sufficient permissions to edit it.', $textarea->getText());
        // Make sure the text format select is not shown.
        $select_id = str_replace('value', 'format--2', $id);
        $this->assertNoSelect($select_id);
    }

}