Setting xBrowser Synchronization Options

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

  1. Click Tools > Options.
  2. Click the plus sign (+) next to Playback in the Options menu tree. The Playback subcategories appear.
  3. Click xBrowser.
  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.
    Tip: Micro Focus recommends adding a substring of an URL to the exclude list, instead of the entire URL. For example, add /syncsample to the exclude list instead of http://example.com/syncsample/timeService. Excluding the entire URL might not work because the browser might return only a relative URL to Silk Test Workbench. For example, if the browser returns only /syncsample/timeService and you have added http://example.com/syncsample/timeService to the exclude list, Silk Test Workbench does not exclude the returned URL.
  5. 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 playback approach without manual script adoptions.
  6. In the Synchronization timeout text box, enter the maximum time, in milliseconds, to wait for an object to be ready. By default this value is set to 300000.
  7. In the Whitelist for iframe support, specify attributes of iframes and frames that should be considered during testing. Every entry in the list defines an attribute name and the corresponding value. All iframes and frames that do not match at least one of the entries are excluded. Wildcards are allowed, for example the entry "name:*form" would include <IFRAME name="user-form" src=…>. This option is ignored by Internet Explorer. If the list is empty, all iframes and frames are considered during testing. Separate multiple entries with a comma.
  8. In the Blacklist for iframe support, specify attributes of iframes and frames that should be excluded during testing. Every entry in the list defines an attribute name and the corresponding value. All iframes and frames that do not match at least one of the entries are considered during testing. Wildcards are allowed, for example the entry "src:*advertising*" would exclude <IFRAME src=http://my.domain/advertising-banner.html>. This option is ignored by Internet Explorer. If the list is empty, all iframes and frames are considered during testing. Separate multiple entries with a comma.
  9. Click OK.