ErrorTest.php in Zircon Profile 8

Contains \Drupal\Tests\Core\Utility\ErrorTest.

Namespace

Drupal\Tests\Core\Utility

File

core/tests/Drupal/Tests/Core/Utility/ErrorTest.php

<?php

/**
 * @file
 * Contains \Drupal\Tests\Core\Utility\ErrorTest.
 */
namespace Drupal\Tests\Core\Utility;

use Drupal\Tests\UnitTestCase;
use Drupal\Core\Utility\Error;

/**
 * @coversDefaultClass \Drupal\Core\Utility\Error
 * @group Utility
 */
class ErrorTest extends UnitTestCase {

  /**
   * Tests the getLastCaller() method.
   *
   * @param array $backtrace
   *   The test backtrace array.
   * @param array $expected
   *   The expected return array.
   *
   * @dataProvider providerTestGetLastCaller
   *
   */
  public function testGetLastCaller($backtrace, $expected) {
    $this
      ->assertSame($expected, Error::getLastCaller($backtrace));
  }

  /**
   * Data provider for testGetLastCaller.
   *
   * @return array
   *   An array of parameter data.
   */
  public function providerTestGetLastCaller() {
    $data = array();

    // Test with just one item. This should default to the function being
    // main().
    $single_item = array(
      $this
        ->createBacktraceItem(),
    );
    $data[] = array(
      $single_item,
      $this
        ->createBacktraceItem('main()'),
    );

    // Add a second item, without a class.
    $two_items = $single_item;
    $two_items[] = $this
      ->createBacktraceItem('test_function_two');
    $data[] = array(
      $two_items,
      $this
        ->createBacktraceItem('test_function_two()'),
    );

    // Add a second item, with a class.
    $two_items = $single_item;
    $two_items[] = $this
      ->createBacktraceItem('test_function_two', 'TestClass');
    $data[] = array(
      $two_items,
      $this
        ->createBacktraceItem('TestClass->test_function_two()'),
    );

    // Add blacklist functions to backtrace. They should get removed.
    foreach (array(
      'debug',
      '_drupal_error_handler',
      '_drupal_exception_handler',
    ) as $function) {
      $two_items = $single_item;

      // Push to the start of the backtrace.
      array_unshift($two_items, $this
        ->createBacktraceItem($function));
      $data[] = array(
        $single_item,
        $this
          ->createBacktraceItem('main()'),
      );
    }
    return $data;
  }

  /**
   * Tests the formatBacktrace() method.
   *
   * @param array $backtrace
   *   The test backtrace array.
   * @param array $expected
   *   The expected return array.
   *
   * @dataProvider providerTestFormatBacktrace
   */
  public function testFormatBacktrace($backtrace, $expected) {
    $this
      ->assertSame($expected, Error::formatBacktrace($backtrace));
  }

  /**
   * Data provider for testFormatBacktrace.
   *
   * @return array
   */
  public function providerTestFormatBacktrace() {
    $data = array();

    // Test with no function, main should be in the backtrace.
    $data[] = array(
      array(
        $this
          ->createBacktraceItem(NULL, NULL),
      ),
      "main()\n",
    );
    $base = array(
      $this
        ->createBacktraceItem(),
    );
    $data[] = array(
      $base,
      "test_function()\n",
    );

    // Add a second item.
    $second_item = $base;
    $second_item[] = $this
      ->createBacktraceItem('test_function_2');
    $data[] = array(
      $second_item,
      "test_function()\ntest_function_2()\n",
    );

    // Add a second item, with a class.
    $second_item_class = $base;
    $second_item_class[] = $this
      ->createBacktraceItem('test_function_2', 'TestClass');
    $data[] = array(
      $second_item_class,
      "test_function()\nTestClass->test_function_2()\n",
    );

    // Add a second item, with a class.
    $second_item_args = $base;
    $second_item_args[] = $this
      ->createBacktraceItem('test_function_2', NULL, array(
      'string',
      10,
      new \stdClass(),
    ));
    $data[] = array(
      $second_item_args,
      "test_function()\ntest_function_2('string', 10, Object)\n",
    );
    return $data;
  }

  /**
   * Creates a mock backtrace item.
   *
   * @param string|NULL $function
   *   (optional) The function name to use in the backtrace item.
   * @param string $class
   *   (optional) The class to use in the backtrace item.
   * @param array $args
   *   (optional) An array of function arguments to add to the backtrace item.
   *
   * @return array
   *   A backtrace array item.
   */
  protected function createBacktraceItem($function = 'test_function', $class = NULL, array $args = array()) {
    $backtrace = array(
      'file' => 'test_file',
      'line' => 10,
      'function' => $function,
      'args' => array(),
    );
    if (isset($class)) {
      $backtrace['class'] = $class;
      $backtrace['type'] = '->';
    }
    if (!empty($args)) {
      $backtrace['args'] = $args;
    }
    return $backtrace;
  }

}

Classes

Name	Description
ErrorTest	@coversDefaultClass \Drupal\Core\Utility\Error @group Utility