Setting xBrowser Synchronization Options

This functionality is supported only if you are using the Open Agent.

Specify the synchronization and timeout values for web applications. Synchronization is performed before and after every method call. A method call is not started and does not end until the synchronization criteria is met.

  1. Click Options > Agent and then click the Synchronization tab.
  2. From the Synchronization mode list box, select the synchronization algorithm for the ready state of a web application.

    The synchronization algorithm configures the waiting period for the ready state of an invoke call.

    Using the HTML mode ensures that all HTML documents are in an interactive state. With this mode, you can test simple Web pages. If more complex scenarios with Java script are used, it might be necessary to manually script synchronization functions.

    Using the AJAX mode eliminates the need to manually script synchronization functions (such as wait for objects to appear or disappear, wait for a specific property value, and so on), which eases the script creation process dramatically. This automatic synchronization is also the base for a successful record and replay approach without manual script adoptions.

  3. In the Synchronization timeout text box, enter the maximum time, in seconds, to wait for an object to be ready.
  4. In the Synchronization exclude list text box, type the entire URL or a fragment of the URL for any service or Web page that you want to exclude.

    Some AJAX frameworks or browser applications use special HTTP requests, which are permanently open in order to retrieve asynchronous data from the server. These requests may let the synchronization hang until the specified synchronization timeout expires. To prevent this situation, either use the HTML synchronization mode or specify the URL of the problematic request in the Synchronization exclude list setting.

    For example, if your web application uses a widget that displays the server time by polling data from the client, permanent traffic is sent to the server for this widget. To exclude this service from the synchronization, determine what the service URL is and enter it in the exclusion list.

    For example, you might type:

    http://example.com/syncsample/timeService
    timeService
    UICallBackServiceHandler

    Separate multiple entries with a comma.

    Note: If your application uses only one service, and you want to disable that service for testing, you must use the HTML synchronization mode rather than adding the service URL to the exclusion list.

  5. Click OK.

    You can now record or manually create a test that uses ignores browser attributes and uses the type of page input that you specified.