Custom Code Steps

How to write and execute custom JavaScript code as test steps — for complex logic, calculations, and DOM interactions that go beyond natural language steps.

Quick answer

How to write and execute custom JavaScript code as test steps — for complex logic, calculations, and DOM interactions that go beyond natural language steps. Use this page to understand when the capability applies, complete its user-facing workflow, and verify the expected result.

What this page covers

Who is this for? SDETs and developers who need to execute custom JavaScript within a test case for logic that cannot be expressed as a natural language step.

Custom code steps let you write JavaScript that executes during test runtime. Use them for complex calculations, custom data transformations, direct DOM manipulation, or any scenario where a natural language instruction is insufficient.

Prerequisites

• You have created or opened a test case.
• You are familiar with the Test Steps Editor basics.
• You have working knowledge of JavaScript.

---

Adding a custom code step

1. Open a test case and click Add Step.
2. In the step builder sidebar, select Custom Code.
3. Select JavaScript from the Language dropdown.
4. Write your code in the code editor.
5. Click Create Step to add the step to your test case.

---

Fields

Field	Description
Language	The scripting language. Currently supports JavaScript.
Code	The JavaScript code to execute at runtime.
Description	A plain-English summary of what the code does. Appears in the step list and execution report.

---

Example: Generate a unique identifier

// Generate a unique email for registration testing
const timestamp = Date.now();
const uniqueEmail = `testuser_${timestamp}@example.com`;
return uniqueEmail;

---

Example: Calculate and verify a total

// Calculate expected cart total from individual prices
const prices = [19.99, 24.50, 7.99];
const expectedTotal = prices.reduce((sum, price) => sum + price, 0).toFixed(2);
return expectedTotal;
// => "52.48"

---

Example: Parse and transform data

// Extract order IDs from a JSON response stored in a variable
const response = JSON.parse(context.variables.orderListResponse);
const orderIds = response.body.orders.map(order => order.id);
return orderIds.join(', ');

Use an AI Ask result in custom code

An AI Ask action can save its answer to a runtime variable. A later Custom Code step can consume that value:

1. Add an AI Ask step, write a focused question, and set its output variable to a valid name such as invoiceSummary.
2. Place the Custom Code step after the AI Ask step.
3. Read the stored value by its exact, case-sensitive name—for example, context.variables.invoiceSummary.
4. Validate or parse the value before using it in a calculation or request.

const summary = String(context.variables.invoiceSummary ?? '').trim();
if (!summary) {
  throw new Error('AI Ask did not return invoiceSummary');
}
return summary.toUpperCase();

AI output is generated text, so do not treat it as a trusted number, selector, command, or JSON object without validation. For an exact value already displayed in the DOM, use Store text from the element … into variable … instead of AI Ask.

Calculation and assertion pattern

For a calculation such as total = subtotal + tax, keep capture, calculation, and verification separate:

1. Store the displayed subtotal and tax in runtime variables.
2. Use Custom Code to parse the currency strings and calculate the expected total with the application's rounding rule.
3. Store or return the calculated value using the output supported by the selected Custom Code template.
4. Add a verification step that compares the displayed total with that expected value.

For a visual, non-critical check, an AI Verification prompt can read: Verify that the displayed Total equals Subtotal plus Tax, using two decimal places. For payment, ledger, or settlement validation, use an exact numeric assertion or API response validation instead of relying only on visual AI reasoning.

---

Advanced settings

Setting	Description
Skip Step	Skip this step during execution without removing it from the test case.
Mark as Optional	If enabled, a failure on this step does not fail the overall test case.

---

Tips & best practices

• Add a descriptive Description field so the step is understandable in the execution report without reading the code.
• Keep code minimal. Custom code steps are for logic that natural language steps cannot handle. If a task can be described in plain English, use an AI Agent step instead.
• Use custom code for data transformation between steps — formatting dates, calculating expected values, parsing complex response structures.
• Avoid long-running operations. The step has a default timeout of 30 seconds. If your code needs more time, increase the step timeout.

Troubleshooting

Custom code step fails with a syntax error Check the browser console output in the execution report. JavaScript syntax errors surface as step failures with the error message in the step details. Validate your code in a browser console before pasting it into the step editor.

Variables from previous steps are not accessible Verify the variable name is spelled correctly and that the step that sets the variable runs before the custom code step. Variable names are case-sensitive.

Related pages

• Test Steps Editor
• Test Data Management
• Creating Test Cases

70% less manual test maintenance with AI self-healing. Book a Demo → — See ContextQA create and maintain tests for your web application.