StorageTest.php

1. 8.x drupal/core/modules/views_ui/lib/Drupal/views_ui/Tests/StorageTest.php
2. 8.x drupal/core/modules/system/lib/Drupal/system/Tests/Form/StorageTest.php

<?php

/**
 * @file
 * Definition of Drupal\system\Tests\Form\StorageTest.
 */
namespace Drupal\system\Tests\Form;

use Drupal\simpletest\WebTestBase;

/**
 * Test the form storage on a multistep form.
 *
 * The tested form puts data into the storage during the initial form
 * construction. These tests verify that there are no duplicate form
 * constructions, with and without manual form caching activiated. Furthermore
 * when a validation error occurs, it makes sure that changed form element
 * values aren't lost due to a wrong form rebuild.
 */
class StorageTest extends WebTestBase {

  /**
   * Modules to enable.
   *
   * @var array
   */
  public static $modules = array(
    'form_test',
  );
  public static function getInfo() {
    return array(
      'name' => 'Multistep form using form storage',
      'description' => 'Tests a multistep form using form storage and makes sure validation and caching works right.',
      'group' => 'Form API',
    );
  }
  function setUp() {
    parent::setUp();
    $this->web_user = $this
      ->drupalCreateUser(array(
      'access content',
    ));
    $this
      ->drupalLogin($this->web_user);
  }

  /**
   * Tests using the form in a usual way.
   */
  function testForm() {
    $this
      ->drupalGet('form_test/form-storage');
    $this
      ->assertText('Form constructions: 1');
    $edit = array(
      'title' => 'new',
      'value' => 'value_is_set',
    );

    // Use form rebuilding triggered by a submit button.
    $this
      ->drupalPost(NULL, $edit, 'Continue submit');
    $this
      ->assertText('Form constructions: 2');
    $this
      ->assertText('Form constructions: 3');

    // Reset the form to the values of the storage, using a form rebuild
    // triggered by button of type button.
    $this
      ->drupalPost(NULL, array(
      'title' => 'changed',
    ), 'Reset');
    $this
      ->assertFieldByName('title', 'new', 'Values have been resetted.');

    // After rebuilding, the form has been cached.
    $this
      ->assertText('Form constructions: 4');
    $this
      ->drupalPost(NULL, $edit, 'Save');
    $this
      ->assertText('Form constructions: 4');
    $this
      ->assertText('Title: new', 'The form storage has stored the values.');
  }

  /**
   * Tests using the form with an activated $form_state['cache'] property.
   */
  function testFormCached() {
    $this
      ->drupalGet('form_test/form-storage', array(
      'query' => array(
        'cache' => 1,
      ),
    ));
    $this
      ->assertText('Form constructions: 1');
    $edit = array(
      'title' => 'new',
      'value' => 'value_is_set',
    );

    // Use form rebuilding triggered by a submit button.
    $this
      ->drupalPost(NULL, $edit, 'Continue submit');
    $this
      ->assertText('Form constructions: 2');

    // Reset the form to the values of the storage, using a form rebuild
    // triggered by button of type button.
    $this
      ->drupalPost(NULL, array(
      'title' => 'changed',
    ), 'Reset');
    $this
      ->assertFieldByName('title', 'new', 'Values have been resetted.');
    $this
      ->assertText('Form constructions: 3');
    $this
      ->drupalPost(NULL, $edit, 'Save');
    $this
      ->assertText('Form constructions: 3');
    $this
      ->assertText('Title: new', 'The form storage has stored the values.');
  }

  /**
   * Tests validation when form storage is used.
   */
  function testValidation() {
    $this
      ->drupalPost('form_test/form-storage', array(
      'title' => '',
      'value' => 'value_is_set',
    ), 'Continue submit');
    $this
      ->assertPattern('/value_is_set/', 'The input values have been kept.');
  }

  /**
   * Tests updating cached form storage during form validation.
   *
   * If form caching is enabled and a form stores data in the form storage, then
   * the form storage also has to be updated in case of a validation error in
   * the form. This test re-uses the existing form for multi-step tests, but
   * triggers a special #element_validate handler to update the form storage
   * during form validation, while another, required element in the form
   * triggers a form validation error.
   */
  function testCachedFormStorageValidation() {

    // Request the form with 'cache' query parameter to enable form caching.
    $this
      ->drupalGet('form_test/form-storage', array(
      'query' => array(
        'cache' => 1,
      ),
    ));

    // Skip step 1 of the multi-step form, since the first step copies over
    // 'title' into form storage, but we want to verify that changes in the form
    // storage are updated in the cache during form validation.
    $edit = array(
      'title' => 'foo',
    );
    $this
      ->drupalPost(NULL, $edit, 'Continue submit');

    // In step 2, trigger a validation error for the required 'title' field, and
    // post the special 'change_title' value for the 'value' field, which
    // conditionally invokes the #element_validate handler to update the form
    // storage.
    $edit = array(
      'title' => '',
      'value' => 'change_title',
    );
    $this
      ->drupalPost(NULL, $edit, 'Save');

    // At this point, the form storage should contain updated values, but we do
    // not see them, because the form has not been rebuilt yet due to the
    // validation error. Post again and verify that the rebuilt form contains
    // the values of the updated form storage.
    $this
      ->drupalPost(NULL, array(
      'title' => 'foo',
      'value' => 'bar',
    ), 'Save');
    $this
      ->assertText("The thing has been changed.", 'The altered form storage value was updated in cache and taken over.');
  }

  /**
   * Tests a form using form state without using 'storage' to pass data from the
   * constructor to a submit handler. The data has to persist even when caching
   * gets activated, what may happen when a modules alter the form and adds
   * #ajax properties.
   */
  function testFormStatePersist() {

    // Test the form one time with caching activated and one time without.
    $run_options = array(
      array(),
      array(
        'query' => array(
          'cache' => 1,
        ),
      ),
    );
    foreach ($run_options as $options) {
      $this
        ->drupalPost('form-test/state-persist', array(), t('Submit'), $options);

      // The submit handler outputs the value in $form_state, assert it's there.
      $this
        ->assertText('State persisted.');

      // Test it again, but first trigger a validation error, then test.
      $this
        ->drupalPost('form-test/state-persist', array(
        'title' => '',
      ), t('Submit'), $options);
      $this
        ->assertText(t('!name field is required.', array(
        '!name' => 'title',
      )));

      // Submit the form again triggering no validation error.
      $this
        ->drupalPost(NULL, array(
        'title' => 'foo',
      ), t('Submit'), $options);
      $this
        ->assertText('State persisted.');

      // Now post to the rebuilt form and verify it's still there afterwards.
      $this
        ->drupalPost(NULL, array(
        'title' => 'bar',
      ), t('Submit'), $options);
      $this
        ->assertText('State persisted.');
    }
  }

}