EditorBaseTest.php

Namespace

Drupal\Tests\editor\Unit

File

core/modules/editor/tests/src/Unit/EditorBaseTest.php

View source
<?php

namespace Drupal\Tests\editor\Unit;

use Drupal\Core\Form\FormState;
use Drupal\Core\Form\FormStateInterface;
use Drupal\Core\Form\SubformState;
use Drupal\editor\Entity\Editor;
use Drupal\editor\Plugin\EditorBase;
use Drupal\Tests\UnitTestCase;

/**
 * @coversDefaultClass \Drupal\editor\Plugin\EditorBase
 * @group editor
 *
 * @group legacy
 */
class EditorBaseTest extends UnitTestCase {
  
  /**
   * @covers ::buildConfigurationForm
   * @covers ::validateConfigurationForm
   * @covers ::submitConfigurationForm
   *
   * @expectedDeprecation Drupal\Tests\editor\Unit\BcEditor::settingsForm is deprecated since version 8.3.x. Rename the implementation 'buildConfigurationForm'. See https://www.drupal.org/node/2819753
   * @expectedDeprecation Drupal\Tests\editor\Unit\BcEditor::settingsFormValidate is deprecated since version 8.3.x. Rename the implementation 'validateConfigurationForm'. See https://www.drupal.org/node/2819753
   * @expectedDeprecation Drupal\Tests\editor\Unit\BcEditor::settingsFormSubmit is deprecated since version 8.3.x. Rename the implementation 'submitConfigurationForm'. See https://www.drupal.org/node/2819753
   */
  public function testBc() {
    $form_state = new FormState();
    $form_state->set('editor', $this->prophesize(Editor::class)
      ->reveal());
    $editor_plugin = new BcEditor([], 'editor_plugin', []);
    // settingsForm() is deprecated in favor of buildConfigurationForm().
    $this->assertSame($editor_plugin->settingsForm([], clone $form_state, $this->prophesize(Editor::class)
      ->reveal()), $editor_plugin->buildConfigurationForm([], clone $form_state));
    // settingsFormValidate() is deprecated in favor of
    // validateConfigurationForm().
    $form = [];
    $form_state_a = clone $form_state;
    $form_state_b = clone $form_state;
    $editor_plugin->settingsFormValidate($form, $form_state_a, $this->prophesize(Editor::class)
      ->reveal());
    $editor_plugin->validateConfigurationForm($form, $form_state_b);
    $this->assertEquals($form_state_a, $form_state_b);
    // settingsFormSubmit() is deprecated in favor of submitConfigurationForm().
    $form = [];
    $form_state_a = clone $form_state;
    $form_state_b = clone $form_state;
    $editor_plugin->settingsFormSubmit($form, $form_state_a, $this->prophesize(Editor::class)
      ->reveal());
    $editor_plugin->submitConfigurationForm($form, $form_state_b);
    $this->assertEquals($form_state_a, $form_state_b);
  }
  
  /**
   * @covers ::buildConfigurationForm
   * @covers ::validateConfigurationForm
   * @covers ::submitConfigurationForm
   */
  public function testBcWithSubformState() {
    $form_state = new FormState();
    $form_state->set('editor', $this->prophesize(Editor::class)
      ->reveal());
    $editor_plugin = new BcEditor([], 'editor_plugin', []);
    $form['#parents'] = [];
    $form['nested'] = [
      '#parents' => [
        'nested',
      ],
    ];
    $subform_state = SubformState::createForSubform($form['nested'], $form, $form_state);
    // settingsForm() uses SubFormState and is deprecated in favor of
    // buildConfigurationForm() which uses FormState, the BC layer ensures they
    // have the same results.
    $this->assertSame($editor_plugin->settingsForm([], clone $form_state, $this->prophesize(Editor::class)
      ->reveal()), $editor_plugin->buildConfigurationForm([], clone $subform_state));
    // settingsForm() uses SubFormState and is deprecated in favor of
    // validateConfigurationForm() which uses FormState, the BC layer ensures
    // they have the same results.
    $form = [];
    $form_state_a = clone $form_state;
    $form_state_b = clone $subform_state;
    $editor_plugin->settingsFormValidate($form, $form_state_a, $this->prophesize(Editor::class)
      ->reveal());
    $editor_plugin->validateConfigurationForm($form, $form_state_b);
    $this->assertEquals('bar', $form_state_a->getValue([
      'nested',
      'foo',
    ]));
    $this->assertEquals('bar', $form_state_b->getValue('foo'));
    $this->assertEquals($form_state_a, $form_state_b->getCompleteFormState());
    // settingsFormSubmit() uses SubFormState and is deprecated in favor of
    // submitConfigurationForm() which uses FormState, the BC layer ensures they
    // have the same results.
    $form = [];
    $form_state_a = clone $form_state;
    $form_state_b = clone $subform_state;
    $editor_plugin->settingsFormSubmit($form, $form_state_a, $this->prophesize(Editor::class)
      ->reveal());
    $editor_plugin->submitConfigurationForm($form, $form_state_b);
    $this->assertEquals('baz', $form_state_a->getValue([
      'nested',
      'bar',
    ]));
    $this->assertEquals('baz', $form_state_b->getValue('bar'));
    $this->assertEquals($form_state_a, $form_state_b->getCompleteFormState());
  }

}
class BcEditor extends EditorBase {
  public function settingsForm(array $form, FormStateInterface $form_state, Editor $editor) {
    return [
      'foo' => 'bar',
    ];
  }
  public function settingsFormValidate(array $form, FormStateInterface $form_state) {
    $form_state->setValue([
      'nested',
      'foo',
    ], 'bar');
  }
  public function settingsFormSubmit(array $form, FormStateInterface $form_state) {
    $form_state->setValue([
      'nested',
      'bar',
    ], 'baz');
  }
  public function getJSSettings(Editor $editor) {
    return [];
  }
  public function getLibraries(Editor $editor) {
    return [];
  }

}

Classes

Title Deprecated Summary
BcEditor
EditorBaseTest @coversDefaultClass \Drupal\editor\Plugin\EditorBase[[api-linebreak]] @group editor

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