All Implemented Interfaces:

IAttributes, ITestResultNotifier, IThreadWorkerFactory<ITestNGMethod>, ITestContext
```
public class TestRunner
extends Object
implements ITestContext, ITestResultNotifier, IThreadWorkerFactory<ITestNGMethod>
```
This class takes care of running one Test.

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static class TestRunner.PriorityWeight

Constructor Summary

Constructors
Modifier	Constructor	Description
	`TestRunner(IConfiguration configuration, ISuite suite, XmlTest test, boolean skipFailedInvocationCounts, Collection<IInvokedMethodListener> invokedMethodListeners, List<IClassListener> classListeners)`	This constructor is used by testng-remote, any changes related to it please contact with testng-team.
	`TestRunner(IConfiguration configuration, ISuite suite, XmlTest test, boolean skipFailedInvocationCounts, Collection<IInvokedMethodListener> invokedMethodListeners, List<IClassListener> classListeners, Comparator<ITestNGMethod> comparator)`
`protected`	`TestRunner(IConfiguration configuration, ISuite suite, XmlTest test, String outputDirectory, IAnnotationFinder finder, boolean skipFailedInvocationCounts, Collection<IInvokedMethodListener> invokedMethodListeners, List<IClassListener> classListeners, Comparator<ITestNGMethod> comparator, Map<Class<? extends IDataProviderListener>,IDataProviderListener> dataProviderListeners)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`void`	`addFailedButWithinSuccessPercentageTest(ITestNGMethod testMethod, ITestResult result)`
`void`	`addFailedTest(ITestNGMethod testMethod, ITestResult result)`
`void`	`addInjector(List<com.google.inject.Module> moduleInstances, com.google.inject.Injector injector)`
`void`	`addInvokedMethod(InvokedMethod im)`
`void`	`addListener(ITestNGListener listener)`
`void`	`addPassedTest(ITestNGMethod tm, ITestResult tr)`
`void`	`addSkippedTest(ITestNGMethod tm, ITestResult tr)`
`List<IWorker<ITestNGMethod>>`	`createWorkers(List<ITestNGMethod> methods)`	Create a list of workers to run the methods passed in parameter.
`ITestNGMethod[]`	`getAfterSuiteMethods()`
`ITestNGMethod[]`	`getAfterTestConfigurationMethods()`
`ITestNGMethod[]`	`getAllTestMethods()`
`Object`	`getAttribute(String name)`
`Set<String>`	`getAttributeNames()`
`ITestNGMethod[]`	`getBeforeSuiteMethods()`
`ITestNGMethod[]`	`getBeforeTestConfigurationMethods()`
`List<IConfigurationListener>`	`getConfigurationListeners()`
`XmlTest`	`getCurrentXmlTest()`
`Date`	`getEndDate()`	When this test stopped running.
`String[]`	`getExcludedGroups()`
`Collection<ITestNGMethod>`	`getExcludedMethods()`
`IResultMap`	`getFailedButWithinSuccessPercentageTests()`
`IResultMap`	`getFailedConfigurations()`	Retrieves information about the failed configuration method invocations.
`IResultMap`	`getFailedTests()`
`Set<ITestResult>`	`getFailedTests(ITestNGMethod tm)`
`List<com.google.inject.Module>`	`getGuiceModules(Class<? extends com.google.inject.Module> cls)`
`String`	`getHost()`
`String[]`	`getIncludedGroups()`
`com.google.inject.Injector`	`getInjector(List<com.google.inject.Module> moduleInstances)`
`com.google.inject.Injector`	`getInjector(IClass iClass)`
`List<ITestNGMethod>`	`getInvokedMethods()`
`IInvoker`	`getInvoker()`
`String`	`getName()`	The name of this test.
`String`	`getOutputDirectory()`
`IResultMap`	`getPassedConfigurations()`	Retrieves information about the successful configuration method invocations.
`IResultMap`	`getPassedTests()`
`Set<ITestResult>`	`getPassedTests(ITestNGMethod tm)`
`IResultMap`	`getSkippedConfigurations()`	Retrieves information about the skipped configuration method invocations.
`IResultMap`	`getSkippedTests()`
`Set<ITestResult>`	`getSkippedTests(ITestNGMethod tm)`
`Date`	`getStartDate()`	When this test started running.
`ISuite`	`getSuite()`
`XmlTest`	`getTest()`
`Collection<ITestClass>`	`getTestClasses()`
`List<ITestListener>`	`getTestListeners()`
`static int`	`getVerbose()`
`Object`	`removeAttribute(String name)`	Remove the attribute
`void`	`run()`	The main entry method for TestRunner.
`void`	`setAttribute(String name, Object value)`	Set a custom attribute.
`void`	`setOutputDirectory(String od)`
`void`	`setTestName(String name)`
`void`	`setVerbose(int n)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - TestRunner
```
protected TestRunner(IConfiguration configuration,
                     ISuite suite,
                     XmlTest test,
                     String outputDirectory,
                     IAnnotationFinder finder,
                     boolean skipFailedInvocationCounts,
                     Collection<IInvokedMethodListener> invokedMethodListeners,
                     List<IClassListener> classListeners,
                     Comparator<ITestNGMethod> comparator,
                     Map<Class<? extends IDataProviderListener>,IDataProviderListener> dataProviderListeners)
```
  - TestRunner
```
public TestRunner(IConfiguration configuration,
                  ISuite suite,
                  XmlTest test,
                  boolean skipFailedInvocationCounts,
                  Collection<IInvokedMethodListener> invokedMethodListeners,
                  List<IClassListener> classListeners,
                  Comparator<ITestNGMethod> comparator)
```
  - TestRunner
```
public TestRunner(IConfiguration configuration,
                  ISuite suite,
                  XmlTest test,
                  boolean skipFailedInvocationCounts,
                  Collection<IInvokedMethodListener> invokedMethodListeners,
                  List<IClassListener> classListeners)
```
    This constructor is used by testng-remote, any changes related to it please contact with testng-team.
- Method Detail
  - getInvoker
```
public IInvoker getInvoker()
```
  - getBeforeSuiteMethods
```
public ITestNGMethod[] getBeforeSuiteMethods()
```
  - getAfterSuiteMethods
```
public ITestNGMethod[] getAfterSuiteMethods()
```
  - getBeforeTestConfigurationMethods
```
public ITestNGMethod[] getBeforeTestConfigurationMethods()
```
  - getAfterTestConfigurationMethods
```
public ITestNGMethod[] getAfterTestConfigurationMethods()
```
  - getTestClasses
```
public Collection<ITestClass> getTestClasses()
```
  - setTestName
```
public void setTestName(String name)
```
  - setOutputDirectory
```
public void setOutputDirectory(String od)
```
  - run
```
public void run()
```
    The main entry method for TestRunner. This is where all the hard work is done: - Invoke configuration methods - Invoke test methods - Catch exceptions - Collect results - Invoke listeners - etc...
  - createWorkers
```
public List<IWorker<ITestNGMethod>> createWorkers(List<ITestNGMethod> methods)
```
    Create a list of workers to run the methods passed in parameter. Each test method is run in its own worker except in the following cases: - The method belongs to a class that has @Test(sequential=true) - The parallel attribute is set to "classes" In both these cases, all the methods belonging to that class will then be put in the same worker in order to run in the same thread.
    
    Specified by:
    
    createWorkers in interface IThreadWorkerFactory<ITestNGMethod>
    
    Parameters:
    
    methods - tasks that need to be executed
    
    Returns:
    
    list of workers
  - getName
```
public String getName()
```
    Description copied from interface: ITestContext
    
    The name of this test.
    
    Specified by:
    
    getName in interface ITestContext
  - getStartDate
```
public Date getStartDate()
```
    Description copied from interface: ITestContext
    
    When this test started running.
    
    Specified by:
    
    getStartDate in interface ITestContext
    
    Returns:
    
    Returns the startDate.
  - getEndDate
```
public Date getEndDate()
```
    Description copied from interface: ITestContext
    
    When this test stopped running.
    
    Specified by:
    
    getEndDate in interface ITestContext
    
    Returns:
    
    Returns the endDate.
  - getPassedTests
```
public IResultMap getPassedTests()
```
    Specified by:
    
    getPassedTests in interface ITestContext
    
    Returns:
    
    A list of all the tests that run successfully.
  - getSkippedTests
```
public IResultMap getSkippedTests()
```
    Specified by:
    
    getSkippedTests in interface ITestContext
    
    Returns:
    
    A list of all the tests that were skipped
  - getFailedTests
```
public IResultMap getFailedTests()
```
    Specified by:
    
    getFailedTests in interface ITestContext
    
    Returns:
    
    A map of all the tests that passed, indexed by their ITextMethor.
    
    See Also:
    
    ITestNGMethod
  - getFailedButWithinSuccessPercentageTests
```
public IResultMap getFailedButWithinSuccessPercentageTests()
```
    Specified by:
    
    getFailedButWithinSuccessPercentageTests in interface ITestContext
    
    Returns:
    
    A list of all the tests that failed but are being ignored because annotated with a successPercentage.
  - getIncludedGroups
```
public String[] getIncludedGroups()
```
    Specified by:
    
    getIncludedGroups in interface ITestContext
    
    Returns:
    
    All the groups that are included for this test run.
  - getExcludedGroups
```
public String[] getExcludedGroups()
```
    Specified by:
    
    getExcludedGroups in interface ITestContext
    
    Returns:
    
    All the groups that are excluded for this test run.
  - getOutputDirectory
```
public String getOutputDirectory()
```
    Specified by:
    
    getOutputDirectory in interface ITestContext
    
    Returns:
    
    Where the reports will be generated.
  - getSuite
```
public ISuite getSuite()
```
    Specified by:
    
    getSuite in interface ITestContext
    
    Returns:
    
    Returns the suite.
  - getAllTestMethods
```
public ITestNGMethod[] getAllTestMethods()
```
    Specified by:
    
    getAllTestMethods in interface ITestContext
    
    Returns:
    
    All the test methods that were run.
  - getHost
```
public String getHost()
```
    Specified by:
    
    getHost in interface ITestContext
    
    Returns:
    
    The host where this test was run, or null if it was run locally. The returned string has the form: host:port
  - getExcludedMethods
```
public Collection<ITestNGMethod> getExcludedMethods()
```
    Specified by:
    
    getExcludedMethods in interface ITestContext
    
    Returns:
    
    All the methods that were not included in this test run.
  - getFailedConfigurations
```
public IResultMap getFailedConfigurations()
```
    Description copied from interface: ITestContext
    
    Retrieves information about the failed configuration method invocations.
    
    Specified by:
    
    getFailedConfigurations in interface ITestContext
    
    See Also:
    
    ITestContext.getFailedConfigurations()
  - getPassedConfigurations
```
public IResultMap getPassedConfigurations()
```
    Description copied from interface: ITestContext
    
    Retrieves information about the successful configuration method invocations.
    
    Specified by:
    
    getPassedConfigurations in interface ITestContext
    
    See Also:
    
    ITestContext.getPassedConfigurations()
  - getSkippedConfigurations
```
public IResultMap getSkippedConfigurations()
```
    Description copied from interface: ITestContext
    
    Retrieves information about the skipped configuration method invocations.
    
    Specified by:
    
    getSkippedConfigurations in interface ITestContext
    
    See Also:
    
    ITestContext.getSkippedConfigurations()
  - addPassedTest
```
public void addPassedTest(ITestNGMethod tm,
                          ITestResult tr)
```
    Specified by:
    
    addPassedTest in interface ITestResultNotifier
  - getPassedTests
```
public Set<ITestResult> getPassedTests(ITestNGMethod tm)
```
    Specified by:
    
    getPassedTests in interface ITestResultNotifier
  - getFailedTests
```
public Set<ITestResult> getFailedTests(ITestNGMethod tm)
```
    Specified by:
    
    getFailedTests in interface ITestResultNotifier
  - getSkippedTests
```
public Set<ITestResult> getSkippedTests(ITestNGMethod tm)
```
    Specified by:
    
    getSkippedTests in interface ITestResultNotifier
  - addSkippedTest
```
public void addSkippedTest(ITestNGMethod tm,
                           ITestResult tr)
```
    Specified by:
    
    addSkippedTest in interface ITestResultNotifier
  - addInvokedMethod
```
public void addInvokedMethod(InvokedMethod im)
```
    Specified by:
    
    addInvokedMethod in interface ITestResultNotifier
  - addFailedTest
```
public void addFailedTest(ITestNGMethod testMethod,
                          ITestResult result)
```
    Specified by:
    
    addFailedTest in interface ITestResultNotifier
  - addFailedButWithinSuccessPercentageTest
```
public void addFailedButWithinSuccessPercentageTest(ITestNGMethod testMethod,
                                                    ITestResult result)
```
    Specified by:
    
    addFailedButWithinSuccessPercentageTest in interface ITestResultNotifier
  - getTest
```
public XmlTest getTest()
```
    Specified by:
    
    getTest in interface ITestResultNotifier
  - getTestListeners
```
public List<ITestListener> getTestListeners()
```
    Specified by:
    
    getTestListeners in interface ITestResultNotifier
  - getConfigurationListeners
```
public List<IConfigurationListener> getConfigurationListeners()
```
    Specified by:
    
    getConfigurationListeners in interface ITestResultNotifier
  - getVerbose
```
public static int getVerbose()
```
  - setVerbose
```
public void setVerbose(int n)
```
  - addListener
```
public void addListener(ITestNGListener listener)
```
  - getInvokedMethods
```
public List<ITestNGMethod> getInvokedMethods()
```
  - getCurrentXmlTest
```
public XmlTest getCurrentXmlTest()
```
    Specified by:
    
    getCurrentXmlTest in interface ITestContext
    
    Returns:
    
    the current XmlTest.
  - getAttribute
```
public Object getAttribute(String name)
```
    Specified by:
    
    getAttribute in interface IAttributes
    
    Parameters:
    
    name - The name of the attribute to return
  - setAttribute
```
public void setAttribute(String name,
                         Object value)
```
    Description copied from interface: IAttributes
    
    Set a custom attribute.
    
    Specified by:
    
    setAttribute in interface IAttributes
  - getAttributeNames
```
public Set<String> getAttributeNames()
```
    Specified by:
    
    getAttributeNames in interface IAttributes
    
    Returns:
    
    all the attributes names.
  - removeAttribute
```
public Object removeAttribute(String name)
```
    Description copied from interface: IAttributes
    
    Remove the attribute
    
    Specified by:
    
    removeAttribute in interface IAttributes
    
    Returns:
    
    the attribute value if found, null otherwise
  - getGuiceModules
```
public List<com.google.inject.Module> getGuiceModules(Class<? extends com.google.inject.Module> cls)
```
    Specified by:
    
    getGuiceModules in interface ITestContext
  - getInjector
```
public com.google.inject.Injector getInjector(List<com.google.inject.Module> moduleInstances)
```
    Specified by:
    
    getInjector in interface ITestContext
  - getInjector
```
public com.google.inject.Injector getInjector(IClass iClass)
```
    Specified by:
    
    getInjector in interface ITestContext
  - addInjector
```
public void addInjector(List<com.google.inject.Module> moduleInstances,
                        com.google.inject.Injector injector)
```
    Specified by:
    
    addInjector in interface ITestContext

Class TestRunner

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

TestRunner

TestRunner

TestRunner

Method Detail

getInvoker

getBeforeSuiteMethods

getAfterSuiteMethods

getBeforeTestConfigurationMethods

getAfterTestConfigurationMethods

getTestClasses

setTestName

setOutputDirectory

run

createWorkers

getName

getStartDate

getEndDate

getPassedTests

getSkippedTests

getFailedTests

getFailedButWithinSuccessPercentageTests

getIncludedGroups

getExcludedGroups

getOutputDirectory

getSuite

getAllTestMethods

getHost

getExcludedMethods

getFailedConfigurations

getPassedConfigurations

getSkippedConfigurations

addPassedTest

getPassedTests

getFailedTests

getSkippedTests

addSkippedTest

addInvokedMethod

addFailedTest

addFailedButWithinSuccessPercentageTest

getTest

getTestListeners

getConfigurationListeners

getVerbose

setVerbose

addListener

getInvokedMethods

getCurrentXmlTest

getAttribute

setAttribute

getAttributeNames

removeAttribute

getGuiceModules

getInjector

getInjector

addInjector