Best Practices for Writing Custom Actions

Last modified: May 15, 2023

1 Introduction

In ATS there are two ways for creating custom actions. First you can extract actions from you test case steps, to encapsulate multiple test steps into a single test step. The second way is to create custom actions from scratch. This section provides you with Do’s and Don’ts for your custom action creation process, to help you achieve the actions you want.

2 Write Reusable and Focused Actions

Use input parameters and generic functions instead of hardcoding every variable or option. Also don’t write actions that do everything at once. Let your actions do one specific task, for example, the retrieval of a WebElement. This serves the readability of your actions/test cases and also makes maintenance much easier.

3 Retrieve WebElements/Widgets Before Applying JavaScript Actions on Them

If you want to access a child node, from a parent widget and you cannot use the Find widget child node action, you should get the parent widget first, before you manipulate the DOM with a JavaScript action. Especially if you use the extended JQuery selectors. Those selectors tend to be slower in their execution time and if you have to traverse the whole DOM to get to the desired node, this can make a huge difference. Use the Find/Assert Widget action on the parent widget and pass the result to the JavaScript action as input parameter. From there you can traverse the subtree with the parent widget as root and save execution time.

For more information about JQuery selectors read the JQuery selectors section of this reference or visit the official JQuery selectors reference.

4 Naming Conventions

Always use descriptive names for your actions and parameters, for example, “Set TextBox value” for an action or “Column Name” for a parameter. This makes it easier to know what your action does, without looking into it.

Some parameter names used by the ATS core library:

  • Widget Name
  • Username
  • Password
  • Caption
  • Column Name
  • Column Value
  • Index
  • Page Title
  • Row/Item
  • Value
  • Element