Over a million developers have joined DZone.

TestNG @Test Annotation – using timeOut Attribute

· Java Zone

Discover how AppDynamics steps in to upgrade your performance game and prevent your enterprise from these top 10 Java performance problems, brought to you in partnership with AppDynamics.

While running test methods there can be cases where certain test methods get struck or may take long time than to complete than expected. In such cases we may need to mark the said test case as fail and then continue with the next test case.

TestNG allows user to configure a time period to wait for a test to completely execute before it can be marked as FAILED.

Here is a quick example


Service Class

package com.skilledmonster.example;
import org.testng.annotations.Test;
* Example to demonstrate use of timeOut attribute of @Test Annotation
* @author Jagadeesh Motamarri
* @version 1.0
public class TestNGAnnotationTestMethodTimeOutExample {
@Test(timeOut = 2000)
public void timeOutTestMethodOne() throws InterruptedException {
System.out.println("TimeOut Test Method One!!");
@Test(timeOut = 5000)
public void timeOutTestMethodTwo() throws InterruptedException {
System.out.println("TimeOut Test Method Two!!");
@Test(timeOut = 2000)
public void timeOutTestMethodRunForEver() {
while (true) {
// Do nothing

In this example there are 3 test methods -

timeOutTestMethodOne() – time out for this method is set to 2 seconds but the current thread that is executing this method goes to sleep for 5 seconds during the executing of the method and eventually the test fails because thread sleep time is more than time out set on the test method.

timeOutTestMethodTwo() – time out for this method is set to 5 seconds but the current thread sleeps only 3 seconds giving a chance for the test method to complete (probably) before the time out.

timeOutTestMethodRunForEver() – this test methods fails after waiting for 2 seconds due to the infinity loop.




The Java Zone is brought to you in partnership with AppDynamics. AppDynamics helps you gain the fundamentals behind application performance, and implement best practices so you can proactively analyze and act on performance problems as they arise, and more specifically with your Java applications. Start a Free Trial.


Published at DZone with permission of Jagadeesh Motamarri, DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.

The best of DZone straight to your inbox.

Please provide a valid email address.

Thanks for subscribing!

Awesome! Check your inbox to verify your email so you can start receiving the latest in tech news and resources.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}