Using Locators in Scripts

Within Silk Test Workbench, literal references to identified objects are referred to as locators. For convenience, you can use shortened forms for the locator strings in scripts. Silk Test Workbench automatically expands the syntax to use full locator strings when you playback a script. When you manually code a script, you can omit the following parts in the following order:

  • The search scope, //.
  • The object type name. Silk Test Workbench defaults to the class name.
  • The surrounding square brackets of the attributes, [ ].

When you manually code a script, we recommend that you use the shortest form available.

Note: You can use shortened forms for the locator strings only when you use a .NET script. For visual tests, you must use full locator strings. When you identify an object, the full locator string is captured by default.
The following locators are equivalent:
  • The first example uses the full locator string.
    _desktop.DomLink("//BrowserApplication//BrowserWindow//a[@textContents='Home']").Select()

    To confirm the full locator string, use the Identify Object dialog box.

  • The second example works when the browser window already exists.
    browserWindow.DomLink("//a[@textContents='Home']").Select()
    Alternatively, you can use the shortened form.
    browserWindow.DomLink("@textContents='Home'").Select()

To find an object that has no real attributes for identification, use the index. For instance, to select the second hyperlink on a Web page, you can type:

browserWindow.DomLink("[2]").Select()

Additionally, to find the first object of its kind, which might be useful if the object has no real attributes, you can type:

browserWindow.DomLink().Select()