BrowserWaitForDisappear Function

Action

This function is useful for custom synchronization. It can be used to wait until a certain DOM element becomes invisible or is detached from the document.

Note: Automatic synchronization is also available. When automatic synchronization is turned on, replay functions wait until the browser has completed loading (including asynchronous remote calls and Javascript processing).

Include file

BrowserAPI.bdh

Syntax

BrowserWaitForDisappear( uTestObject : in union,
                         nTimeout    : in union optional ): boolean;
Parameter Description
uTestObject The XPath locator or the handle to the DOM element.
nTimeout Optional: The wait timeout in milliseconds. If not specified, the default timeout specified in the profile settings or set by BrowserSetOption(BROWSER_OPT_WAIT_TIMEOUT) will be used. When the timeout is reached, an error is thrown. Use the data type number for this parameter. The data type float is not allowed.

Return value

  • true if successful

  • false otherwise

Example

benchmark SilkPerformerRecorder

use "Kernel.bdh"
use "BrowserAPI.bdh"

dcluser
  user
    VUser
  transactions
    TInit           : begin;
    TMain           : 1;

var

dclrand

dcltrans
  transaction TInit
  begin
  end TInit;

  transaction TMain
  begin
    BrowserStart(BROWSER_MODE_DEFAULT | BROWSER_MODE_USERBEHAVIOR_FIRST_TIME, 800, 600);
    
    // wait for DOM element to disappear (should disappear after 2.5 seconds)
    BrowserNavigate("http://demo.borland.com/TestSite/JavaScriptDisappear.html");

    BrowserWaitForDisappear("//SPAN[@id='ToHide']", 1000);
  end TMain;