JS Steps

We like to say that we are a no-code solution. However, that does not mean that you can’t code! You can cover a broad spectrum of testing natively within Autify, but some of our clients have more advanced testing needs and want to go beyond Autify’s native capabilities; In those instances, clients can utilize JavaScript to greatly expand the scope of their testing.

What is a JS Step?

[JS Step] is a function that allows you to execute JavaScript within Autify’s [Scenario].
This function enables capabilities that are unsupported by Autify’s standard functions.

Given its powerful nature, we have provided a detailed explanation below.
After the section on how to use this function, you will find specific use cases in the latter part of this article. We hope they are useful!

How to Add a JS Step in Your Scenario

1. Go to the Scenario Details Page where you want to add the JS Step

2. Move the cursor in between the steps where you want to add the JS Step
   

3. Click the + icon and and select Insert Step. Select JS Step from the menu that appears.
   

4. Type your JavaScript code in the text editor. The code will already be wrapped in a function, so no need to include that syntax.
   

5. You can optionally name your JS Step, as well as include a Memo, such as a description of what is happening on this particular step
   

6. Click Save

Use a value obtained or generated in a JS Step in other steps

In [JS Step], you can obtain information from elements displayed on the page or generate values. return allows you to use this information in subsequent steps. The actual return value can be seen on the test result.

If you have not return in JS step, this value will be null.

Used in the operation and assertion step

1. In the Scenario Details Page, click on the step you wish to insert the return value in
2. In the Text to assign dropdown, select Other step's result and select the desired JS Step whose data you wish to insert
   

Use as Arguments of a JS Step

Values returned by a JS step can be used as arguments for other JS steps. Details are explained in the section "Using Arguments in JS Step" below.

Using Arguments in a JS Step

1. Click on the thumbnail of the JS Step, which you want to pass in an argument for.

2. Click on the + icon within the parenthesis of the function
   

3. Enter the name of your argument and click Add
   

4. In the Argument Values, select the type of value you'd like to pass in

   • Given value allows you to hardcode in a string
   • Test email address allows you to select a pre-created test email address
   • Data allows you to select the columns of data in the scenario
   • Other step's result allows you to pass in the return value of a previous JS Step or Dynamic Value
     

5. To delete or rename an argument that has already been added, click on the target argument and make the necessary edits
   

JavaScript Snippets

For your convenience, we have compiled dozens of the most commonly used JS code snippets when testing with Autify; You can find a link to our JS Snippets here.

How to use JavaScript Snippets

1. Add a JS step to the scenario

2. In the Autify JS Snippet database, select the snippet you wish to use
   

3. Copy the JS snippet by hovering over it and clicking the "copy" icon on the top right corner of the snippet
   

4. Paste the snippet into your JS Step and make the necessary changes to the code to suit your test
   

JS Steps Use Cases

There are many different ways you can use JS Steps to test with Autify. Here are some example use cases:

• API calls
• Handling cookies
• Custom assertions