class BatchBuilderTest
Tests for the batch builder class.
Attributes
#[CoversClass(BatchBuilder::class)]
#[Group('system')]
  Hierarchy
- class \Drupal\Tests\UnitTestCase uses \Drupal\Tests\PhpUnitCompatibilityTrait, \Prophecy\PhpUnit\ProphecyTrait, \Drupal\TestTools\Extension\DeprecationBridge\ExpectDeprecationTrait, \Drupal\Tests\RandomGeneratorTrait extends \PHPUnit\Framework\TestCase- class \Drupal\Tests\Core\Batch\BatchBuilderTest extends \Drupal\Tests\UnitTestCase
 
Expanded class hierarchy of BatchBuilderTest
File
- 
              core/tests/ Drupal/ Tests/ Core/ Batch/ BatchBuilderTest.php, line 16 
Namespace
Drupal\Tests\Core\BatchView source
class BatchBuilderTest extends UnitTestCase {
  
  /**
   * Tests the default values.
   *
   * @legacy-covers ::toArray
   */
  public function testDefaultValues() : void {
    $batch = (new BatchBuilder())->toArray();
    $this->assertIsArray($batch);
    $this->assertArrayHasKey('operations', $batch);
    $this->assertIsArray($batch['operations']);
    $this->assertEmpty($batch['operations'], 'Operations array is empty.');
    $this->assertEquals(new TranslatableMarkup('Processing'), $batch['title']);
    $this->assertEquals(new TranslatableMarkup('Initializing.'), $batch['init_message']);
    $this->assertEquals(new TranslatableMarkup('Completed @current of @total.'), $batch['progress_message']);
    $this->assertEquals(new TranslatableMarkup('An error has occurred.'), $batch['error_message']);
    $this->assertNull($batch['finished']);
    $this->assertNull($batch['file']);
    $this->assertArrayHasKey('library', $batch);
    $this->assertIsArray($batch['library']);
    $this->assertEmpty($batch['library']);
    $this->assertArrayHasKey('url_options', $batch);
    $this->assertIsArray($batch['url_options']);
    $this->assertEmpty($batch['url_options']);
    $this->assertArrayHasKey('progressive', $batch);
    $this->assertTrue($batch['progressive']);
    $this->assertArrayNotHasKey('queue', $batch);
  }
  
  /**
   * Tests setTitle().
   *
   * @legacy-covers ::setTitle
   */
  public function testSetTitle() : void {
    $batch = (new BatchBuilder())->setTitle(new TranslatableMarkup('New Title'))
      ->toArray();
    $this->assertEquals(new TranslatableMarkup('New Title'), $batch['title']);
  }
  
  /**
   * Tests setFinishCallback().
   *
   * @legacy-covers ::setFinishCallback
   */
  public function testSetFinishCallback() : void {
    $batch = (new BatchBuilder())->setFinishCallback('\\Drupal\\Tests\\Core\\Batch\\BatchBuilderTest::finishedCallback')
      ->toArray();
    $this->assertEquals('\\Drupal\\Tests\\Core\\Batch\\BatchBuilderTest::finishedCallback', $batch['finished']);
  }
  
  /**
   * Tests setInitMessage().
   *
   * @legacy-covers ::setInitMessage
   */
  public function testSetInitMessage() : void {
    $batch = (new BatchBuilder())->setInitMessage(new TranslatableMarkup('New initialization message.'))
      ->toArray();
    $this->assertEquals(new TranslatableMarkup('New initialization message.'), $batch['init_message']);
  }
  
  /**
   * Tests setProgressMessage().
   *
   * @legacy-covers ::setProgressMessage
   */
  public function testSetProgressMessage() : void {
    $batch = (new BatchBuilder())->setProgressMessage(new TranslatableMarkup('Batch in progress...'))
      ->toArray();
    $this->assertEquals(new TranslatableMarkup('Batch in progress...'), $batch['progress_message']);
  }
  
  /**
   * Tests setErrorMessage().
   */
  public function testSetErrorMessage() : void {
    $batch = (new BatchBuilder())->setErrorMessage(new TranslatableMarkup('Oops. An error has occurred :('))
      ->toArray();
    $this->assertEquals(new TranslatableMarkup('Oops. An error has occurred :('), $batch['error_message']);
  }
  
  /**
   * Tests setFile().
   *
   * @legacy-covers ::setFile
   */
  public function testSetFile() : void {
    $filename = $this->root . '/core/modules/system/tests/modules/batch_test/batch_test.set_file.inc';
    $this->assertIsNotCallable('_batch_test_set_file_callback_1');
    $this->assertIsNotCallable('_batch_test_set_file_finished_1');
    $batch = (new BatchBuilder())->setFile($filename)
      ->setFinishCallback('_batch_test_set_file_finished_1')
      ->addOperation('_batch_test_set_file_callback_1', [])
      ->toArray();
    $this->assertEquals($filename, $batch['file']);
    $this->assertEquals([
      [
        '_batch_test_set_file_callback_1',
        [],
      ],
    ], $batch['operations']);
    $this->assertEquals('_batch_test_set_file_finished_1', $batch['finished']);
    $this->assertIsCallable('_batch_test_set_file_callback_1');
    $this->assertIsCallable('_batch_test_set_file_finished_1');
  }
  
  /**
   * Tests setting and adding libraries.
   *
   * @legacy-covers ::setLibraries
   */
  public function testAddingLibraries() : void {
    $batch = (new BatchBuilder())->setLibraries([
      'only/library',
    ])
      ->toArray();
    $this->assertEquals([
      'only/library',
    ], $batch['library']);
  }
  
  /**
   * Tests setProgressive().
   *
   * @legacy-covers ::setProgressive
   */
  public function testSetProgressive() : void {
    $batch_builder = new BatchBuilder();
    $batch = $batch_builder->setProgressive(FALSE)
      ->toArray();
    $this->assertFalse($batch['progressive']);
    $batch = $batch_builder->setProgressive(TRUE)
      ->toArray();
    $this->assertTrue($batch['progressive']);
  }
  
  /**
   * Tests setQueue().
   *
   * @legacy-covers ::setQueue
   */
  public function testSetQueue() : void {
    $batch = (new BatchBuilder())->setQueue('BatchName', '\\Drupal\\Core\\Queue\\Batch')
      ->toArray();
    $this->assertEquals([
      'name' => 'BatchName',
      'class' => '\\Drupal\\Core\\Queue\\Batch',
    ], $batch['queue'], 'Batch queue has been set.');
  }
  
  /**
   * Tests queue class exists.
   *
   * @legacy-covers ::setQueue
   */
  public function testQueueExists() : void {
    $batch_builder = new BatchBuilder();
    $this->expectException(\InvalidArgumentException::class);
    $this->expectExceptionMessage('Class \\ThisIsNotAClass does not exist.');
    $batch_builder->setQueue('BatchName', '\\ThisIsNotAClass');
  }
  
  /**
   * Tests queue class implements \Drupal\Core\Queue\QueueInterface.
   *
   * @legacy-covers ::setQueue
   */
  public function testQueueImplements() : void {
    $batch_builder = new BatchBuilder();
    $this->expectException(\InvalidArgumentException::class);
    $this->expectExceptionMessage('Class Exception does not implement \\Drupal\\Core\\Queue\\QueueInterface.');
    $batch_builder->setQueue('BatchName', \Exception::class);
  }
  
  /**
   * Tests setUrlOptions().
   *
   * @legacy-covers ::setUrlOptions
   */
  public function testSetUrlOptions() : void {
    $options = [
      'absolute' => TRUE,
      'language' => 'de',
    ];
    $batch = (new BatchBuilder())->setUrlOptions($options)
      ->toArray();
    $this->assertEquals($options, $batch['url_options']);
  }
  
  /**
   * Tests addOperation().
   *
   * @legacy-covers ::addOperation
   */
  public function testAddOperation() : void {
    $batch_builder = new BatchBuilder();
    $batch = $batch_builder->addOperation('\\Drupal\\Tests\\Core\\Batch\\BatchBuilderTest::operationCallback')
      ->toArray();
    $this->assertEquals([
      [
        '\\Drupal\\Tests\\Core\\Batch\\BatchBuilderTest::operationCallback',
        [],
      ],
    ], $batch['operations']);
    $batch = $batch_builder->addOperation('\\Drupal\\Tests\\Core\\Batch\\BatchBuilderTest::operationCallback', [
      2,
    ])
      ->addOperation('\\Drupal\\Tests\\Core\\Batch\\BatchBuilderTest::operationCallback', [
      3,
    ])
      ->toArray();
    $this->assertEquals([
      [
        '\\Drupal\\Tests\\Core\\Batch\\BatchBuilderTest::operationCallback',
        [],
      ],
      [
        '\\Drupal\\Tests\\Core\\Batch\\BatchBuilderTest::operationCallback',
        [
          2,
        ],
      ],
      [
        '\\Drupal\\Tests\\Core\\Batch\\BatchBuilderTest::operationCallback',
        [
          3,
        ],
      ],
    ], $batch['operations']);
  }
  
  /**
   * Tests registering IDs of built batches.
   *
   * @legacy-covers ::isSetIdRegistered
   * @legacy-covers ::registerSetId
   */
  public function testRegisterIds() : void {
    $setId = $this->randomMachineName();
    $this->assertFalse(BatchBuilder::isSetIdRegistered($setId));
    (new BatchBuilder())->registerSetId($setId);
    $this->assertTrue(BatchBuilder::isSetIdRegistered($setId));
  }
  
  /**
   * Empty callback for the tests.
   *
   * @internal
   */
  public static function finishedCallback() {
  }
  
  /**
   * Empty callback for the tests.
   *
   * @internal
   */
  public static function operationCallback() {
  }
}Members
| Title Sort descending | Modifiers | Object type | Summary | Overrides | 
|---|---|---|---|---|
| BatchBuilderTest::finishedCallback | public static | function | Empty callback for the tests. | |
| BatchBuilderTest::operationCallback | public static | function | Empty callback for the tests. | |
| BatchBuilderTest::testAddingLibraries | public | function | Tests setting and adding libraries. | |
| BatchBuilderTest::testAddOperation | public | function | Tests addOperation(). | |
| BatchBuilderTest::testDefaultValues | public | function | Tests the default values. | |
| BatchBuilderTest::testQueueExists | public | function | Tests queue class exists. | |
| BatchBuilderTest::testQueueImplements | public | function | Tests queue class implements \Drupal\Core\Queue\QueueInterface. | |
| BatchBuilderTest::testRegisterIds | public | function | Tests registering IDs of built batches. | |
| BatchBuilderTest::testSetErrorMessage | public | function | Tests setErrorMessage(). | |
| BatchBuilderTest::testSetFile | public | function | Tests setFile(). | |
| BatchBuilderTest::testSetFinishCallback | public | function | Tests setFinishCallback(). | |
| BatchBuilderTest::testSetInitMessage | public | function | Tests setInitMessage(). | |
| BatchBuilderTest::testSetProgressive | public | function | Tests setProgressive(). | |
| BatchBuilderTest::testSetProgressMessage | public | function | Tests setProgressMessage(). | |
| BatchBuilderTest::testSetQueue | public | function | Tests setQueue(). | |
| BatchBuilderTest::testSetTitle | public | function | Tests setTitle(). | |
| BatchBuilderTest::testSetUrlOptions | public | function | Tests setUrlOptions(). | |
| ExpectDeprecationTrait::expectDeprecation | public | function | Adds an expected deprecation. | |
| ExpectDeprecationTrait::setUpErrorHandler | public | function | Sets up the test error handler. | |
| ExpectDeprecationTrait::tearDownErrorHandler | public | function | Tears down the test error handler. | |
| RandomGeneratorTrait::getRandomGenerator | protected | function | Gets the random generator for the utility methods. | |
| RandomGeneratorTrait::randomMachineName | protected | function | Generates a unique random string containing letters and numbers. | |
| RandomGeneratorTrait::randomObject | public | function | Generates a random PHP object. | |
| RandomGeneratorTrait::randomString | public | function | Generates a pseudo-random string of ASCII characters of codes 32 to 126. | |
| UnitTestCase::$root | protected | property | The app root. | |
| 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::getContainerWithCacheTagsInvalidator | protected | function | Sets up a container with a cache tags invalidator. | |
| UnitTestCase::getStringTranslationStub | public | function | Returns a stub translation manager that just returns the passed string. | |
| UnitTestCase::setDebugDumpHandler | public static | function | Registers the dumper CLI handler when the DebugDump extension is enabled. | |
| UnitTestCase::setUp | protected | function | 366 | |
| UnitTestCase::setupMockIterator | protected | function | Set up a traversable class mock to return specific items when iterated. | 
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.
