class CKEditorLoadingTest in Drupal 10

Tests loading of CKEditor.

@group ckeditor

Hierarchy

• class \Drupal\Tests\BrowserTestBase extends \PHPUnit\Framework\TestCase uses \Symfony\Bridge\PhpUnit\ExpectDeprecationTrait, \Drupal\Tests\PhpUnitCompatibilityTrait, FunctionalTestSetupTrait, TestSetupTrait, BlockCreationTrait, ConfigTestTrait, ExtensionListTestTrait, ContentTypeCreationTrait, NodeCreationTrait, RandomGeneratorTrait, TestRequirementsTrait, PhpUnitWarnings, UiHelperTrait, UserCreationTrait, XdebugRequestTrait
  • class \Drupal\Tests\ckeditor\Functional\CKEditorLoadingTest

File

core/modules/ckeditor/tests/src/Functional/CKEditorLoadingTest.php, line 14

Namespace

Drupal\Tests\ckeditor\Functional

class CKEditorLoadingTest extends BrowserTestBase {

  /**
   * Modules to enable.
   *
   * @var array
   */
  protected static $modules = [
    'filter',
    'editor',
    'ckeditor',
    'node',
  ];

  /**
   * {@inheritdoc}
   */
  protected $defaultTheme = 'stark';

  /**
   * An untrusted user with access to only the 'plain_text' format.
   *
   * @var \Drupal\user\UserInterface
   */
  protected $untrustedUser;

  /**
   * A normal user with access to the 'plain_text' and 'filtered_html' formats.
   *
   * @var \Drupal\user\UserInterface
   */
  protected $normalUser;
  protected function setUp() : void {
    parent::setUp();

    // Create text format, associate CKEditor.
    $filtered_html_format = FilterFormat::create([
      'format' => 'filtered_html',
      'name' => 'Filtered HTML',
      'weight' => 0,
      'filters' => [],
    ]);
    $filtered_html_format
      ->save();
    $editor = Editor::create([
      'format' => 'filtered_html',
      'editor' => 'ckeditor',
    ]);
    $editor
      ->save();

    // Create a second format without an associated editor so a drop down select
    // list is created when selecting formats.
    $full_html_format = FilterFormat::create([
      'format' => 'full_html',
      'name' => 'Full HTML',
      'weight' => 1,
      'filters' => [],
    ]);
    $full_html_format
      ->save();

    // Create node type.
    $this
      ->drupalCreateContentType([
      'type' => 'article',
      'name' => 'Article',
    ]);
    $this->untrustedUser = $this
      ->drupalCreateUser([
      'create article content',
      'edit any article content',
    ]);
    $this->normalUser = $this
      ->drupalCreateUser([
      'create article content',
      'edit any article content',
      'use text format filtered_html',
      'use text format full_html',
    ]);
  }

  /**
   * Tests loading of CKEditor CSS, JS and JS settings.
   */
  public function testLoading() {

    // The untrusted user:
    // - has access to 1 text format (plain_text);
    // - doesn't have access to the filtered_html text format, so: no text editor.
    $this
      ->drupalLogin($this->untrustedUser);
    $this
      ->drupalGet('node/add/article');
    [
      $settings,
      $editor_settings_present,
      $editor_js_present,
    ] = $this
      ->getThingsToCheck();
    $this
      ->assertFalse($editor_settings_present, 'No Text Editor module settings.');
    $this
      ->assertFalse($editor_js_present, 'No Text Editor JavaScript.');
    $this
      ->assertSession()
      ->fieldExists('edit-body-0-value');
    $this
      ->assertSession()
      ->elementNotExists('css', 'select.js-filter-list');

    // Verify that a single text format hidden input does not exist on the page.
    $this
      ->assertSession()
      ->elementNotExists('xpath', '//input[@type="hidden" and contains(@class, "editor")]');

    // Verify that CKEditor glue JS is absent.
    $this
      ->assertSession()
      ->responseNotContains($this
      ->getModulePath('ckeditor') . '/js/ckeditor.js');

    // On pages where there would never be a text editor, CKEditor JS is absent.
    $this
      ->drupalGet('user');
    $this
      ->assertSession()
      ->responseNotContains($this
      ->getModulePath('ckeditor') . '/js/ckeditor.js');

    // The normal user:
    // - has access to 2 text formats;
    // - does have access to the filtered_html text format, so: CKEditor.
    $this
      ->drupalLogin($this->normalUser);
    $this
      ->drupalGet('node/add/article');
    [
      $settings,
      $editor_settings_present,
      $editor_js_present,
    ] = $this
      ->getThingsToCheck();
    $ckeditor_plugin = $this->container
      ->get('plugin.manager.editor')
      ->createInstance('ckeditor');
    $editor = Editor::load('filtered_html');
    $expected = [
      'formats' => [
        'filtered_html' => [
          'format' => 'filtered_html',
          'editor' => 'ckeditor',
          'editorSettings' => $ckeditor_plugin
            ->getJSSettings($editor),
          'editorSupportsContentFiltering' => TRUE,
          'isXssSafe' => FALSE,
        ],
      ],
    ];
    $this
      ->assertTrue($editor_settings_present, "Text Editor module's JavaScript settings are on the page.");
    $this
      ->assertEquals($expected, $settings['editor'], "Text Editor module's JavaScript settings on the page are correct.");
    $this
      ->assertTrue($editor_js_present, 'Text Editor JavaScript is present.');
    $this
      ->assertSession()
      ->fieldExists('edit-body-0-value');

    // Verify that a single text format selector exists on the page and has a
    // "data-editor-for" attribute with the correct value.
    $this
      ->assertSession()
      ->elementsCount('css', 'select.js-filter-list', 1);
    $select = $this
      ->assertSession()
      ->elementExists('css', 'select.js-filter-list');
    $this
      ->assertSame('edit-body-0-value', $select
      ->getAttribute('data-editor-for'));
    $this
      ->assertContains('ckeditor/drupal.ckeditor', explode(',', $settings['ajaxPageState']['libraries']), 'CKEditor glue library is present.');

    // Enable the ckeditor_test module, customize configuration. In this case,
    // there is additional CSS and JS to be loaded.
    // NOTE: the tests in CKEditorTest already ensure that changing the
    // configuration also results in modified CKEditor configuration, so we
    // don't test that here.
    \Drupal::service('module_installer')
      ->install([
      'ckeditor_test',
    ]);
    $this->container
      ->get('plugin.manager.ckeditor.plugin')
      ->clearCachedDefinitions();
    $editor_settings = $editor
      ->getSettings();
    $editor_settings['toolbar']['rows'][0][0]['items'][] = 'Llama';
    $editor
      ->setSettings($editor_settings);
    $editor
      ->save();
    $this
      ->drupalGet('node/add/article');
    [
      $settings,
      $editor_settings_present,
      $editor_js_present,
    ] = $this
      ->getThingsToCheck();
    $expected = [
      'formats' => [
        'filtered_html' => [
          'format' => 'filtered_html',
          'editor' => 'ckeditor',
          'editorSettings' => $ckeditor_plugin
            ->getJSSettings($editor),
          'editorSupportsContentFiltering' => TRUE,
          'isXssSafe' => FALSE,
        ],
      ],
    ];
    $this
      ->assertTrue($editor_settings_present, "Text Editor module's JavaScript settings are on the page.");
    $this
      ->assertEquals($expected, $settings['editor'], "Text Editor module's JavaScript settings on the page are correct.");
    $this
      ->assertTrue($editor_js_present, 'Text Editor JavaScript is present.');
    $this
      ->assertContains('ckeditor/drupal.ckeditor', explode(',', $settings['ajaxPageState']['libraries']), 'CKEditor glue library is present.');

    // Assert that CKEditor uses Drupal's cache-busting query string by
    // comparing the setting sent with the page with the current query string.
    $settings = $this
      ->getDrupalSettings();
    $expected = $settings['ckeditor']['timestamp'];
    $this
      ->assertSame($expected, \Drupal::state()
      ->get('system.css_js_query_string'), "CKEditor scripts cache-busting string is correct before flushing all caches.");

    // Flush all caches then make sure that $settings['ckeditor']['timestamp']
    // still matches.
    $this
      ->resetAll();
    $this
      ->assertSame($expected, \Drupal::state()
      ->get('system.css_js_query_string'), "CKEditor scripts cache-busting string is correct after flushing all caches.");
  }

  /**
   * Tests presence of essential configuration even without Internal's buttons.
   */
  public function testLoadingWithoutInternalButtons() {

    // Change the CKEditor text editor configuration to only have link buttons.
    // This means:
    // - 0 buttons are from \Drupal\ckeditor\Plugin\CKEditorPlugin\Internal
    // - 2 buttons are from \Drupal\ckeditor\Plugin\CKEditorPlugin\DrupalLink
    $filtered_html_editor = Editor::load('filtered_html');
    $settings = $filtered_html_editor
      ->getSettings();
    $settings['toolbar']['rows'] = [
      0 => [
        0 => [
          'name' => 'Links',
          'items' => [
            'DrupalLink',
            'DrupalUnlink',
          ],
        ],
      ],
    ];
    $filtered_html_editor
      ->setSettings($settings)
      ->save();

    // Even when no buttons of \Drupal\ckeditor\Plugin\CKEditorPlugin\Internal
    // are in use, its configuration (Internal::getConfig()) is still essential:
    // this is configuration that is associated with the (custom, optimized)
    // build of CKEditor that Drupal core ships with. For example, it configures
    // CKEditor to not perform its default action of loading a config.js file,
    // to not convert special characters into HTML entities, and the allowedContent
    // setting to configure CKEditor's Advanced Content Filter.
    $this
      ->drupalLogin($this->normalUser);
    $this
      ->drupalGet('node/add/article');
    $editor_settings = $this
      ->getDrupalSettings()['editor']['formats']['filtered_html']['editorSettings'];
    $this
      ->assertTrue(isset($editor_settings['customConfig']));
    $this
      ->assertTrue(isset($editor_settings['entities']));
    $this
      ->assertTrue(isset($editor_settings['allowedContent']));
    $this
      ->assertTrue(isset($editor_settings['disallowedContent']));
  }
  protected function getThingsToCheck() {
    $settings = $this
      ->getDrupalSettings();
    return [
      // JavaScript settings.
      $settings,
      // Editor.module's JS settings present.
      isset($settings['editor']),
      // Editor.module's JS present. Note: ckeditor/drupal.ckeditor depends on
      // editor/drupal.editor, hence presence of the former implies presence of
      // the latter.
      isset($settings['ajaxPageState']['libraries']) && in_array('ckeditor/drupal.ckeditor', explode(',', $settings['ajaxPageState']['libraries'])),
    ];
  }

}