simpletest.api.php

Hooks provided by the SimpleTest module.

File

drupal/core/modules/simpletest/simpletest.api.php
View source
<?php

/**
 * @file
 * Hooks provided by the SimpleTest module.
 */

/**
 * Global variable that holds information about the tests being run.
 *
 * An array, with the following keys:
 *  - 'test_run_id': the ID of the test being run, in the form 'simpletest_%"
 *  - 'in_child_site': TRUE if the current request is a cURL request from
 *     the parent site.
 *
 * @var array
 */
global $drupal_test_info;

/**
 * @addtogroup hooks
 * @{
 */

/**
 * Alter the list of tests.
 *
 * @param $groups
 *   A two dimension array, the first key is the test group (as defined in
 *   getInfo) the second is the name of the class and the value is the return
 *   value of the getInfo method.
 */
function hook_simpletest_alter(&$groups) {

  // An alternative session handler module would not want to run the original
  // Session HTTPS handling test because it checks the sessions table in the
  // database.
  unset($groups['Session']['testHttpsSession']);
}

/**
 * A test group has started.
 *
 * This hook is called just once at the beginning of a test group.
 */
function hook_test_group_started() {
}

/**
 * A test group has finished.
 *
 * This hook is called just once at the end of a test group.
 */
function hook_test_group_finished() {
}

/**
 * An individual test has finished.
 *
 * This hook is called when an individual test has finished.
 *
 * @param
 *   $results The results of the test as gathered by Drupal\simpletest\WebTestBase.
 *
 * @see Drupal\simpletest\WebTestBase->results()
 */
function hook_test_finished($results) {
}

/**
 * @} End of "addtogroup hooks".
 */

Functions

Namesort ascending Description
hook_test_group_started A test group has started.
hook_test_group_finished A test group has finished.
hook_test_finished An individual test has finished.
hook_simpletest_alter Alter the list of tests.

Globals

Namesort ascending Description
$drupal_test_info Global variable that holds information about the tests being run.