class SubformStateTest in Drupal 10

Same name and namespace in other branches

8 core/tests/Drupal/Tests/Core/Form/SubformStateTest.php \Drupal\Tests\Core\Form\SubformStateTest
9 core/tests/Drupal/Tests/Core/Form/SubformStateTest.php \Drupal\Tests\Core\Form\SubformStateTest

@coversDefaultClass \Drupal\Core\Form\SubformState

@group Form

Hierarchy

class \Drupal\Tests\UnitTestCase extends \PHPUnit\Framework\TestCase uses \Drupal\Tests\PhpUnitCompatibilityTrait, \Symfony\Bridge\PhpUnit\ExpectDeprecationTrait, PhpUnitWarnings
- class \Drupal\Tests\Core\Form\SubformStateTest

Expanded class hierarchy of SubformStateTest

File

core/tests/Drupal/Tests/Core/Form/SubformStateTest.php, line 17

Namespace

Drupal\Tests\Core\Form

View source

class SubformStateTest extends UnitTestCase {

  /**
   * The form state's values test fixture.
   *
   * @var mixed[]
   */
  protected $formStateValues = [
    'foo' => 'bar',
    'dog' => [
      'breed' => 'Pit bull',
      'name' => 'Dodger',
    ],
  ];

  /**
   * The parent form.
   *
   * @var mixed[]
   */
  protected $parentForm = [
    '#parents' => [],
    'foo' => [
      '#parents' => [
        'foo',
      ],
      '#array_parents' => [
        'foo',
      ],
    ],
    'dog' => [
      '#parents' => [
        'dog',
      ],
      '#array_parents' => [
        'dog',
      ],
      'breed' => [
        '#parents' => [
          'dog',
          'breed',
        ],
        '#array_parents' => [
          'dog',
          'breed',
        ],
      ],
      'name' => [
        '#parents' => [
          'dog',
          'name',
        ],
        '#array_parents' => [
          'dog',
          'name',
        ],
      ],
    ],
  ];

  /**
   * @covers ::getValues
   * @covers ::getParents
   *
   * @dataProvider providerGetValues
   *
   * @param string[] $parents
   *   The parents.
   * @param string $expected
   *   The expected state values.
   */
  public function testGetValues(array $parents, $expected) {
    $parent_form_state = new FormState();
    $parent_form_state
      ->setValues($this->formStateValues);
    $subform = NestedArray::getValue($this->parentForm, $parents);
    $subform_state = SubformState::createForSubform($subform, $this->parentForm, $parent_form_state);
    $subform_state_values =& $subform_state
      ->getValues();
    $this
      ->assertSame($expected, $subform_state_values);

    // Modify the retrieved values and confirm they are modified by reference in
    // the parent form state.
    $subform_state_values['fish'] = 'Jim';
    $this
      ->assertSame($subform_state_values, $subform_state
      ->getValues());
  }

  /**
   * Provides data to self::testGetValues().
   */
  public function providerGetValues() {
    $data = [];
    $data['exist'] = [
      [
        'dog',
      ],
      $this->formStateValues['dog'],
    ];
    return $data;
  }

  /**
   * @covers ::getValues
   * @covers ::getParents
   *
   * @dataProvider providerGetValuesBroken
   *
   * @param string[] $parents
   *   The parents.
   * @param string $expected
   *   The expected state values.
   */
  public function testGetValuesBroken(array $parents, $expected) {
    $this
      ->expectException(\UnexpectedValueException::class);
    $this
      ->testGetValues($parents, $expected);
  }

  /**
   * Provides data to self::testGetValuesBroken().
   */
  public function providerGetValuesBroken() {
    $data = [];
    $data['exist'] = [
      [
        'foo',
      ],
      $this->formStateValues['foo'],
    ];
    $data['nested'] = [
      [
        'dog',
        'name',
      ],
      'Dodger',
    ];
    return $data;
  }

  /**
   * @covers ::getValue
   *
   * @dataProvider providerTestGetValue
   */
  public function testGetValue($parents, $key, $expected, $default = NULL) {
    $parent_form_state = new FormState();
    $parent_form_state
      ->setValues($this->formStateValues);
    $subform = NestedArray::getValue($this->parentForm, $parents);
    $subform_state = SubformState::createForSubform($subform, $this->parentForm, $parent_form_state);
    $subform_state_value =& $subform_state
      ->getValue($key, $default);
    $this
      ->assertSame($expected, $subform_state_value);

    // Modify the retrieved values and confirm they are modified by reference in
    // the parent form state.
    $subform_state_value = 'Jim';
    $this
      ->assertSame($subform_state_value, $subform_state
      ->getValue($key));
  }

  /**
   * Provides data to self::testGetValue().
   */
  public function providerTestGetValue() {
    $data = [];
    $data['exist'] = [
      [
        'dog',
      ],
      'name',
      'Dodger',
    ];
    return $data;
  }

  /**
   * @covers ::getValue
   *
   * @dataProvider providerTestGetValueBroken
   */
  public function testGetValueBroken(array $parents, $key, $expected, $default = NULL) {
    $this
      ->expectException(\UnexpectedValueException::class);
    $this
      ->testGetValue($parents, $key, $expected, $default);
  }

  /**
   * Provides data to self::testGetValueBroken().
   */
  public function providerTestGetValueBroken() {
    $data = [];
    $data['nested'] = [
      [
        'dog',
        'name',
      ],
      NULL,
      'Dodger',
    ];
    return $data;
  }

  /**
   * @covers ::setValues
   *
   * @dataProvider providerTestSetValues
   */
  public function testSetValues($parents, $new_values, $expected) {
    $parent_form_state = new FormState();
    $parent_form_state
      ->setValues($this->formStateValues);
    $subform = NestedArray::getValue($this->parentForm, $parents);
    $subform_state = SubformState::createForSubform($subform, $this->parentForm, $parent_form_state);
    $this
      ->assertSame($subform_state, $subform_state
      ->setValues($new_values));
    $this
      ->assertSame($expected, $parent_form_state
      ->getValues());
  }

  /**
   * Provides data to self::testSetValues().
   */
  public function providerTestSetValues() {
    $data = [];
    $data['exist'] = [
      [
        'dog',
      ],
      [],
      [
        'foo' => 'bar',
        'dog' => [],
      ],
    ];
    return $data;
  }

  /**
   * @covers ::setValues
   *
   * @dataProvider providerTestSetValuesBroken
   */
  public function testSetValuesBroken($parents, $new_values, $expected) {
    $this
      ->expectException(\UnexpectedValueException::class);
    $this
      ->testSetValues($parents, $new_values, $expected);
  }

  /**
   * Provides data to self::testSetValuesBroken().
   */
  public function providerTestSetValuesBroken() {
    $data = [];
    $data['exist'] = [
      [
        'foo',
      ],
      [],
      [
        'foo' => [],
        'dog' => $this->formStateValues['dog'],
      ],
    ];
    return $data;
  }

  /**
   * @covers ::getCompleteFormState
   */
  public function testGetCompleteFormStateWithParentCompleteForm() {
    $parent_form_state = $this
      ->prophesize(FormStateInterface::class);
    $subform_state = SubformState::createForSubform($this->parentForm['dog'], $this->parentForm, $parent_form_state
      ->reveal());
    $this
      ->assertSame($parent_form_state
      ->reveal(), $subform_state
      ->getCompleteFormState());
  }

  /**
   * @covers ::getCompleteFormState
   */
  public function testGetCompleteFormStateWithParentSubform() {
    $complete_form_state = $this
      ->prophesize(FormStateInterface::class);
    $parent_form_state = $this
      ->prophesize(SubformStateInterface::class);
    $parent_form_state
      ->getCompleteFormState()
      ->willReturn($complete_form_state
      ->reveal())
      ->shouldBeCalled();
    $subform_state = SubformState::createForSubform($this->parentForm['dog'], $this->parentForm, $parent_form_state
      ->reveal());
    $this
      ->assertSame($complete_form_state
      ->reveal(), $subform_state
      ->getCompleteFormState());
  }

  /**
   * @covers ::setLimitValidationErrors
   */
  public function testSetLimitValidationErrors() {
    $parent_limit_validation_errors = [
      'dog',
      'name',
    ];
    $limit_validation_errors = [
      'name',
    ];
    $parent_form_state = $this
      ->prophesize(FormStateInterface::class);
    $parent_form_state
      ->setLimitValidationErrors($parent_limit_validation_errors)
      ->shouldBeCalled();
    $subform_state = SubformState::createForSubform($this->parentForm['dog'], $this->parentForm, $parent_form_state
      ->reveal());
    $this
      ->assertSame($subform_state, $subform_state
      ->setLimitValidationErrors($limit_validation_errors));
  }

  /**
   * @covers ::getLimitValidationErrors
   */
  public function testGetLimitValidationErrors() {
    $parent_limit_validation_errors = [
      'dog',
      'name',
    ];
    $limit_validation_errors = [
      'name',
    ];
    $parent_form_state = $this
      ->prophesize(FormStateInterface::class);
    $parent_form_state
      ->getLimitValidationErrors()
      ->willReturn($parent_limit_validation_errors)
      ->shouldBeCalled();
    $subform_state = SubformState::createForSubform($this->parentForm['dog'], $this->parentForm, $parent_form_state
      ->reveal());
    $this
      ->assertSame($limit_validation_errors, $subform_state
      ->getLimitValidationErrors());
  }

  /**
   * @covers ::setErrorByName
   */
  public function testSetErrorByName() {
    $parent_form_error_name = 'dog][name';
    $subform_error_name = 'name';

    // cSpell:disable-next-line
    $message = 'De kat krabt de krullen van de trap.';
    $parent_form_state = $this
      ->prophesize(FormStateInterface::class);
    $parent_form_state
      ->setErrorByName($parent_form_error_name, $message)
      ->shouldBeCalled();
    $subform_state = SubformState::createForSubform($this->parentForm['dog'], $this->parentForm, $parent_form_state
      ->reveal());
    $this
      ->assertSame($subform_state, $subform_state
      ->setErrorByName($subform_error_name, $message));
  }

}

Members

Name	Modifiers	Type	Description	Overrides
PhpUnitWarnings::$deprecationWarnings	private static	property	Deprecation warnings from PHPUnit to raise with @trigger_error().
PhpUnitWarnings::addWarning	public	function	Converts PHPUnit deprecation warnings to E_USER_DEPRECATED.
SubformStateTest::$formStateValues	protected	property	The form state's values test fixture.
SubformStateTest::$parentForm	protected	property	The parent form.
SubformStateTest::providerGetValues	public	function	Provides data to self::testGetValues().
SubformStateTest::providerGetValuesBroken	public	function	Provides data to self::testGetValuesBroken().
SubformStateTest::providerTestGetValue	public	function	Provides data to self::testGetValue().
SubformStateTest::providerTestGetValueBroken	public	function	Provides data to self::testGetValueBroken().
SubformStateTest::providerTestSetValues	public	function	Provides data to self::testSetValues().
SubformStateTest::providerTestSetValuesBroken	public	function	Provides data to self::testSetValuesBroken().
SubformStateTest::testGetCompleteFormStateWithParentCompleteForm	public	function	@covers ::getCompleteFormState
SubformStateTest::testGetCompleteFormStateWithParentSubform	public	function	@covers ::getCompleteFormState
SubformStateTest::testGetLimitValidationErrors	public	function	@covers ::getLimitValidationErrors
SubformStateTest::testGetValue	public	function	@covers ::getValue
SubformStateTest::testGetValueBroken	public	function	@covers ::getValue
SubformStateTest::testGetValues	public	function	@covers ::getValues @covers ::getParents
SubformStateTest::testGetValuesBroken	public	function	@covers ::getValues @covers ::getParents
SubformStateTest::testSetErrorByName	public	function	@covers ::setErrorByName
SubformStateTest::testSetLimitValidationErrors	public	function	@covers ::setLimitValidationErrors
SubformStateTest::testSetValues	public	function	@covers ::setValues
SubformStateTest::testSetValuesBroken	public	function	@covers ::setValues
UnitTestCase::$randomGenerator	protected	property	The random generator.
UnitTestCase::$root	protected	property	The app root.	1
UnitTestCase::getClassResolverStub	protected	function	Returns a stub class resolver.
UnitTestCase::getConfigFactoryStub	public	function	Returns a stub config factory that behaves according to the passed array.
UnitTestCase::getConfigStorageStub	public	function	Returns a stub config storage that returns the supplied configuration.
UnitTestCase::getContainerWithCacheTagsInvalidator	protected	function	Sets up a container with a cache tags invalidator.
UnitTestCase::getRandomGenerator	protected	function	Gets the random generator for the utility methods.
UnitTestCase::getStringTranslationStub	public	function	Returns a stub translation manager that just returns the passed string.
UnitTestCase::randomMachineName	public	function	Generates a unique random string containing letters and numbers.
UnitTestCase::setUp	protected	function		206
UnitTestCase::setUpBeforeClass	public static	function

You are here

class SubformStateTest in Drupal 10

Hierarchy

File

Namespace

Members

API Navigation