function FileFieldWidgetTestCase::testMultiValuedWidget

7.x file.test FileFieldWidgetTestCase::testMultiValuedWidget()

Tests upload and remove buttons for multiple multi-valued File fields.

File

drupal-7.x/modules/file/tests/file.test, line 389
Tests for file.module.

Class

FileFieldWidgetTestCase
Tests file field widget.

Code

function testMultiValuedWidget() {
  // Use 'page' instead of 'article', so that the 'article' image field does
  // not conflict with this test. If in the future the 'page' type gets its
  // own default file or image field, this test can be made more robust by
  // using a custom node type.
  $type_name = 'page';
  $field_name = strtolower($this->randomName());
  $field_name2 = strtolower($this->randomName());
  $this->createFileField($field_name, $type_name, array('cardinality' => 3));
  $this->createFileField($field_name2, $type_name, array('cardinality' => 3));

  $field = field_info_field($field_name);
  $instance = field_info_instance('node', $field_name, $type_name);

  $field2 = field_info_field($field_name2);
  $instance2 = field_info_instance('node', $field_name2, $type_name);

  $test_file = $this->getTestFile('text');

  foreach (array('nojs', 'js') as $type) {
    // Visit the node creation form, and upload 3 files for each field. Since
    // the field has cardinality of 3, ensure the "Upload" button is displayed
    // until after the 3rd file, and after that, isn't displayed. Because
    // SimpleTest triggers the last button with a given name, so upload to the
    // second field first.
    // @todo This is only testing a non-Ajax upload, because drupalPostAJAX()
    //   does not yet emulate jQuery's file upload.
    //
    $this->drupalGet("node/add/$type_name");
    foreach (array($field_name2, $field_name) as $each_field_name) {
      for ($delta = 0; $delta < 3; $delta++) {
        $edit = array('files[' . $each_field_name . '_' . LANGUAGE_NONE . '_' . $delta . ']' => drupal_realpath($test_file->uri));
        // If the Upload button doesn't exist, drupalPost() will automatically
        // fail with an assertion message.
        $this->drupalPost(NULL, $edit, t('Upload'));
      }
    }
    $this->assertNoFieldByXpath('//input[@type="submit"]', t('Upload'), 'After uploading 3 files for each field, the "Upload" button is no longer displayed.');

    $num_expected_remove_buttons = 6;

    foreach (array($field_name, $field_name2) as $current_field_name) {
      // How many uploaded files for the current field are remaining.
      $remaining = 3;
      // Test clicking each "Remove" button. For extra robustness, test them out
      // of sequential order. They are 0-indexed, and get renumbered after each
      // iteration, so array(1, 1, 0) means:
      // - First remove the 2nd file.
      // - Then remove what is then the 2nd file (was originally the 3rd file).
      // - Then remove the first file.
      foreach (array(1, 1, 0) as $delta) {
        // Ensure we have the expected number of Remove buttons, and that they
        // are numbered sequentially.
        $buttons = $this->xpath('//input[@type="submit" and @value="Remove"]');
        $this->assertTrue(is_array($buttons) && count($buttons) === $num_expected_remove_buttons, format_string('There are %n "Remove" buttons displayed (JSMode=%type).', array('%n' => $num_expected_remove_buttons, '%type' => $type)));
        foreach ($buttons as $i => $button) {
          $key = $i >= $remaining ? $i - $remaining : $i;
          $check_field_name = $field_name2;
          if ($current_field_name == $field_name && $i < $remaining) {
            $check_field_name = $field_name;
          }

          $this->assertIdentical((string) $button['name'], $check_field_name . '_' . LANGUAGE_NONE . '_' . $key . '_remove_button');
        }

        // "Click" the remove button (emulating either a nojs or js submission).
        $button_name = $current_field_name . '_' . LANGUAGE_NONE . '_' . $delta . '_remove_button';
        switch ($type) {
          case 'nojs':
            // drupalPost() takes a $submit parameter that is the value of the
            // button whose click we want to emulate. Since we have multiple
            // buttons with the value "Remove", and want to control which one we
            // use, we change the value of the other ones to something else.
            // Since non-clicked buttons aren't included in the submitted POST
            // data, and since drupalPost() will result in $this being updated
            // with a newly rebuilt form, this doesn't cause problems.
            foreach ($buttons as $button) {
              if ($button['name'] != $button_name) {
                $button['value'] = 'DUMMY';
              }
            }
            $this->drupalPost(NULL, array(), t('Remove'));
            break;
          case 'js':
            // drupalPostAJAX() lets us target the button precisely, so we don't
            // require the workaround used above for nojs.
            $this->drupalPostAJAX(NULL, array(), array($button_name => t('Remove')));
            break;
        }
        $num_expected_remove_buttons--;
        $remaining--;

        // Ensure an "Upload" button for the current field is displayed with the
        // correct name.
        $upload_button_name = $current_field_name . '_' . LANGUAGE_NONE . '_' . $remaining . '_upload_button';
        $buttons = $this->xpath('//input[@type="submit" and @value="Upload" and @name=:name]', array(':name' => $upload_button_name));
        $this->assertTrue(is_array($buttons) && count($buttons) == 1, format_string('The upload button is displayed with the correct name (JSMode=%type).', array('%type' => $type)));

        // Ensure only at most one button per field is displayed.
        $buttons = $this->xpath('//input[@type="submit" and @value="Upload"]');
        $expected = $current_field_name == $field_name ? 1 : 2;
        $this->assertTrue(is_array($buttons) && count($buttons) == $expected, format_string('After removing a file, only one "Upload" button for each possible field is displayed (JSMode=%type).', array('%type' => $type)));
      }
    }

    // Ensure the page now has no Remove buttons.
    $this->assertNoFieldByXPath('//input[@type="submit"]', t('Remove'), format_string('After removing all files, there is no "Remove" button displayed (JSMode=%type).', array('%type' => $type)));

    // Save the node and ensure it does not have any files.
    $this->drupalPost(NULL, array('title' => $this->randomName()), t('Save'));
    $matches = array();
    preg_match('/node\/([0-9]+)/', $this->getUrl(), $matches);
    $nid = $matches[1];
    $node = node_load($nid, NULL, TRUE);
    $this->assertTrue(empty($node->{$field_name}[LANGUAGE_NONE][0]['fid']), 'Node was successfully saved without any files.');
  }
}