goog.testing.TestCase Classgoog.testing.TestCase(opt_name)A class representing a JsUnit test case. A TestCase is made up of a number of test functions which can be run. Individual test cases can override the following functions to set up their test environment: - runTests - completely override the test's runner - setUpPage - called before any of the test functions are run - tearDownPage - called after all tests are finished - setUp - called before each of the test functions - tearDown - called after each of the test functions - shouldRunTests - called before a test run, all tests are skipped if it returns false. Can be used to disable tests on browsers where they aren't expected to pass. Use {@link #autoDiscoverTests}
opt_name {string=}
goog.testing.TestCase.Error ClassA class representing an error thrown by the test … more
.IS_IE {boolean}Avoid a dependency on goog.userAgent and keep our own reference of whether the browser is IE.
.MAX_RUN_TIME {number}The maximum amount of time that the test can run before we force it to be async. This prevents the test runner from blocking the browser and potentially hurting the Selenium test harness.
goog.testing.TestCase.Order EnumThe order to run the auto-discovered tests. … more
goog.testing.TestCase.Result ClassA class for representing test results. A bag of public properties. … more
goog.testing.TestCase.Test ClassA class representing a single test function. … more
.add(test)Adds a new test to the test case.
test {goog.testing.TestCase.Test}
.autoDiscoverTests()Adds any functions defined in the global scope that are prefixed with "test" to the test case. Also overrides setUp, tearDown, setUpPage, tearDownPage and runTests if they are defined.
.clearTimeout(id) [protected]Clears a timeout created by {@code this.timeout()}.
id {number}
.createTestFromAutoDiscoveredFunction(name, ref) [protected]Creates a {@code goog.testing.TestCase.Test} from an auto-discovered function.
name {string}
ref {function() : void}
goog.testing.TestCase.Test}
.currentTestName {?string}TODO(user) replace this with prototype.currentTest. Name of the current test that is running, or null if none is running.
.cycleTests()Cycles through the tests, breaking out using a setTimeout if the execution time has execeeded {@link #MAX_RUN_TIME}.
.doError(test, opt_e) [protected]Handles a test that failed.
test {goog.testing.TestCase.Test}
opt_e {*=}
.doSuccess(test) [protected]Handles a test that passed.
test {goog.testing.TestCase.Test}
.exceptionBeforeTest [protected] {*}Exception object that was detected before a test runs.
.execute()Executes each of the tests.
.finalize()Finalizes the test case, called when the tests have finished executing.
.getActuallyRunCount()Returns the number of tests actually run in the test case, i.e. subtracting any which are skipped.
number}
.getAutoDiscoveryPrefix() [protected]string}
.getBatchTime() [protected]number}
.getCount()Returns the number of tests contained in the test case.
number}
.getGlobals(opt_prefix)Gets the object with all globals.
opt_prefix {string=}
Object}
.getNumFilesLoaded()Returns the number of script files that were loaded in order to run the test.
number}
.getReport(opt_verbose)Returns a string detailing the results from the test.
opt_verbose {boolean=}
string}
.getRunTime()Returns the amount of time it took for the test to run.
number}
.getTests() [protected]Gets the tests.
Array.<goog.testing.TestCase.Test>}
.initializeTestRunner(testCase)Initializes the given test case with the global test runner 'G_testRunner'.
testCase {goog.testing.TestCase}
.isInsideMultiTestRunner()boolean}
.isSuccess()boolean}
.log(val)Logs an object to the console, if available.
val {*}
.logError(name, opt_e)name {string}
opt_e {*=}
goog.testing.TestCase.Error}
.maybeFailTestEarly(testCase) [protected]Checks to see if the test should be marked as failed before it is run. If there was an error in setUpPage, we treat that as a failure for all tests and mark them all as having failed.
testCase {goog.testing.TestCase.Test}
boolean}
.next()Returns the current test and increments the pointer.
goog.testing.TestCase.Test?}
.now() [protected]number}
.order {string}The order to run the auto-discovered tests in.
.reset()Resets the test case pointer, so that next returns the first test.
.result_ [protected] {goog.testing.TestCase.Result}Object used to encapsulate the test results.
.runTests()Executes each of the tests. Overridable by the individual test case. This allows test cases to defer when the test is actually started. If overridden, finalize must be called by the test to indicate it has finished.
.running {boolean}Whether the test case is running.
.saveMessage(message)Saves a message to the result set.
message {string}
.setBatchTime(batchTime) [protected]batchTime {number}
.setCompletedCallback(fn)Sets the callback function that should be executed when the tests have completed.
fn {Function}
.setTestRunner(tr)Sets the test runner that is running this test case.
tr {goog.testing.TestRunner}
.setTests(tests) [protected]Sets the tests.
tests {Array.<goog.testing.TestCase.Test>}
.setUp()Gets called before every goog.testing.TestCase.Test is been executed. Can be overridden to add set up functionality to each test.
.setUpPage()Gets called before any tests are executed. Can be overridden to set up the environment for the whole test case.
.shouldRunTests()Can be overridden in test classes to indicate whether the tests in a case should be run in that particular situation. For example, this could be used to stop tests running in a particular browser, where browser support for the class under test was absent.
boolean}
.started {boolean}Whether the test case has ever tried to execute.
.tearDown()Gets called after every goog.testing.TestCase.Test has been executed. Can be overriden to add tear down functionality to each test.
.tearDownPage()Gets called after all tests have been executed. Can be overridden to tear down the entire test case.
.timeout(fn, time) [protected]Calls a function after a delay, using the protected timeout.
fn {Function}
time {number}
number}