function DrupalTestCase::assert

Internal helper: stores the assert.

Parameters

$status: Can be 'pass', 'fail', 'exception'. TRUE is a synonym for 'pass', FALSE for 'fail'.

$message: The message string.

$group: Which group this assert belongs to.

$caller: By default, the assert comes from a function whose name starts with 'test'. Instead, you can specify where this assert originates from by passing in an associative array as $caller. Key 'file' is the name of the source file, 'line' is the line number and 'function' is the caller function itself.

File

modules/simpletest/drupal_web_test_case.php, line 165

Class

DrupalTestCase

Base class for Drupal tests.

Code

protected function assert($status, $message = '', $group = 'Other', array $caller = NULL) {
    // Convert boolean status to string status.
    if (is_bool($status)) {
        $status = $status ? 'pass' : 'fail';
    }
    // Increment summary result counter.
    $this->results['#' . $status]++;
    // Get the function information about the call to the assertion method.
    if (!$caller) {
        $caller = $this->getAssertionCall();
    }
    // Creation assertion array that can be displayed while tests are running.
    $this->assertions[] = $assertion = array(
        'test_id' => $this->testId,
        'test_class' => get_class($this),
        'status' => $status,
        'message' => $message,
        'message_group' => $group,
        'function' => $caller['function'],
        'line' => $caller['line'],
        'file' => $caller['file'],
    );
    // Store assertion for display after the test has completed.
    self::getDatabaseConnection()->insert('simpletest')
        ->fields($assertion)
        ->execute();
    // We do not use a ternary operator here to allow a breakpoint on
    // test failure.
    if ($status == 'pass') {
        return TRUE;
    }
    else {
        return FALSE;
    }
}