Skip to main content

​
Description

The wait method pauses test execution for a specified number of milliseconds before continuing. This is useful for adding delays between actions, waiting for animations to complete, or pausing for state changes to settle.

​
Syntax

await testdriver.wait(timeout);

​
Arguments

ArgumentTypeDefaultDescription
timeoutnumber3000The duration in milliseconds to wait.

​
Examples

// Wait 2 seconds for an animation to complete
await testdriver.find('submit button').click();
await testdriver.wait(2000);

// Wait 5 seconds
await testdriver.wait(5000);

// Wait with default timeout (3 seconds)
await testdriver.wait();

​
Best Practices

  • Use for simple delays — waiting for animations, transitions, or state changes after an action.
  • Avoid for element waiting — if you’re waiting for a specific element to appear, use find() with a timeout option instead: 
    // ✅ Better for waiting for elements
const element = await testdriver.find('success message', { timeout: 30000 });

// ❌ Don't do this for element waiting
await testdriver.wait(5000);
const element = await testdriver.find('success message');
  • Avoid excessively long timeouts to keep tests efficient.
  • Use sparingly — TestDriver’s redraw detection automatically waits for screen and network stability after each action.