class ProcessFieldTest

Same name and namespace in other branches
  1. 11.x core/modules/field/tests/src/Unit/Plugin/migrate/process/ProcessFieldTest.php \Drupal\Tests\field\Unit\Plugin\migrate\process\ProcessFieldTest
  2. 10 core/modules/field/tests/src/Unit/Plugin/migrate/process/ProcessFieldTest.php \Drupal\Tests\field\Unit\Plugin\migrate\process\ProcessFieldTest
  3. 8.9.x core/modules/field/tests/src/Unit/Plugin/migrate/process/ProcessFieldTest.php \Drupal\Tests\field\Unit\Plugin\migrate\process\ProcessFieldTest

Tests the ProcessField migrate process plugin.

@coversDefaultClass \Drupal\field\Plugin\migrate\process\ProcessField
@group field

Hierarchy

Expanded class hierarchy of ProcessFieldTest

File

core/modules/field/tests/src/Unit/Plugin/migrate/process/ProcessFieldTest.php, line 21

Namespace

Drupal\Tests\field\Unit\Plugin\migrate\process
View source
class ProcessFieldTest extends MigrateTestCase {
  
  /**
   * @var \Drupal\migrate_drupal\Plugin\MigrateFieldPluginManagerInterface|\Prophecy\Prophecy\ObjectProphecy
   */
  protected $fieldManager;
  
  /**
   * @var \Drupal\migrate_drupal\Plugin\MigrateFieldInterface|\Prophecy\Prophecy\ObjectProphecy
   */
  protected $fieldPlugin;
  
  /**
   * @var \Drupal\migrate\MigrateExecutable|\Prophecy\Prophecy\ObjectProphecy
   */
  protected $migrateExecutable;
  
  /**
   * @var \Drupal\migrate\Plugin\MigrationInterface|\Prophecy\Prophecy\ObjectProphecy
   */
  protected $migration;
  
  /**
   * @var \Drupal\migrate\Row|\Prophecy\Prophecy\ObjectProphecy
   */
  protected $row;
  
  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    $this->fieldManager = $this->prophesize(MigrateFieldPluginManagerInterface::class);
    $this->fieldPlugin = $this->prophesize(MigrateFieldInterface::class);
    $this->migrateExecutable = $this->prophesize(MigrateExecutable::class);
    $this->migration = $this->prophesize(MigrationInterface::class);
    $this->row = $this->prophesize(Row::class);
    $this->fieldManager
      ->getPluginIdFromFieldType('foo', [], $this->migration
      ->reveal())
      ->willReturn('foo');
    $this->fieldManager
      ->createInstance('foo', [], $this->migration
      ->reveal())
      ->willReturn($this->fieldPlugin);
    parent::setUp();
  }
  
  /**
   * Tests the transform method.
   *
   * @param string $method
   *   The method to call.
   * @param string $value
   *   The value to process.
   * @param mixed $expected_value
   *   The expected transformed value.
   * @param string $migrate_exception
   *   The MigrateException message to expect.
   * @param bool $plugin_not_found
   *   Whether the field plugin is not found.
   *
   * @covers ::transform
   * @dataProvider providerTestTransform
   */
  public function testTransform($method, $value, $expected_value, $migrate_exception = '', $plugin_not_found = FALSE) {
    if ($method) {
      $this->fieldPlugin
        ->{$method}($this->row
        ->reveal())
        ->willReturn($expected_value);
    }
    $plugin = new ProcessField([
      'method' => $method,
    ], $value, [], $this->fieldManager
      ->reveal(), $this->migration
      ->reveal());
    if ($migrate_exception) {
      $this->expectException(MigrateException::class);
      $this->expectExceptionMessage($migrate_exception);
    }
    if ($plugin_not_found) {
      $exception = new PluginNotFoundException('foo');
      $this->fieldManager
        ->getPluginIdFromFieldType()
        ->willThrow($exception);
    }
    $transformed_value = $plugin->transform($value, $this->migrateExecutable
      ->reveal(), $this->row
      ->reveal(), 'foo');
    $this->assertSame($transformed_value, $expected_value);
  }
  
  /**
   * Provides data for the transform method test.
   *
   * @return array
   *   - The method to call.
   *   - The value to process.
   *   - The expected transformed value.
   *   - The MigrateException message to expect.
   *   - Whether the field plugin is not found.
   */
  public function providerTestTransform() {
    return [
      // Tests the getFieldType() method.
[
        'method' => 'getFieldType',
        'value' => 'foo',
        'expected_value' => 'bar',
      ],
      // Tests the getFieldFormatterMap() method.
[
        'method' => 'getFieldFormatterMap',
        'value' => 'foo',
        'expected_value' => [
          'foo' => 'bar',
        ],
      ],
      // Tests the getFieldWidgetMap() method.
[
        'method' => 'getFieldWidgetMap',
        'value' => 'foo',
        'expected_value' => [
          'foo' => 'bar',
        ],
      ],
      // Tests that an exception is thrown if the value is not a string.
[
        'method' => 'getFieldType',
        'value' => [
          'foo',
        ],
        'expected_value' => '',
        'migrate_exception' => 'The input value must be a string.',
      ],
      // Tests that an exception is thrown if no method name is provided.
[
        'method' => '',
        'value' => '',
        'expected_value' => '',
        'migrate_exception' => 'You need to specify the name of a method to be called on the Field plugin.',
      ],
      // Tests that NULL is returned if no field plugin is found.
[
        'method' => 'getFieldType',
        'value' => 'foo',
        'expected_value' => NULL,
        'migrate_exception' => '',
        'plugin_not_found' => TRUE,
      ],
    ];
  }

}

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