Skip to main content

​
Overview

Expressions let you inject dynamic values into step fields without writing full code. They are evaluated at runtime and can reference:
  • env.*: environment variables from your selected Environment
  • vars.*: test variables produced by earlier steps (e.g., Extract Text)
  • random.*: built‑in random data generators (email, name, uuid, etc.)
Use expressions inside double braces {{ ... }}. You can mix text with expressions, chain methods, and apply simple JavaScript. Expressions in step fields

​
When to use

  • Build URLs from environment values and previous step outputs
  • Fill forms with dynamic or random data
  • Verify text or URLs that contain variable parts
  • Drive conditional logic using values computed on the fly

​
Autocomplete and sources

In supported fields, typing {{ opens an autocomplete with tabs for Env, Vars, and Random. Select an item to insert it automatically. Autocomplete with Env/Vars/Random tabs
  • Env (env.*): Read‑only key‑values defined in the selected Environment
  • Vars (vars.*): Values saved by earlier steps in the same test case
  • Random (random.*): Utilities like email(), firstName(), uuid(), number(min,max)

​
Syntax

  • Wrap in braces: {{ ... }}
  • Mix with static text: Hello {{ vars.firstName }}!
  • Chain methods: {{ vars.email.trim().toLowerCase() }}
  • Build paths: {{ env.API_BASE }}/users/{{ vars.userId }}
  • Generate data: {{ random.email() }}

​
Common examples

  • URL from env and vars: {{ env.APP_URL }}/account/{{ vars.accountId }}
  • Normalizing a value: {{ vars.username.strip().lower() }}
  • Array operations: {{ [t.strip() for t in env.TAGS.split(',')] }}
  • Fallbacks: {{ vars.displayName or env.DEFAULT_NAME }}
  • Compose multiple parts: Hello {{ vars.firstName }} {{ vars.lastName }}!

​
Where it works

  • Navigate (URL)
  • Fill Text (value)
  • Verify Text / Verify URL (expected value)
  • Select Option (value)
  • Start Condition (expression)
  • Other fields that support text input in the editor

​
Expressions in locators

You can use expressions in element locators.
  • String locators (e.g., CSS, text engine): If a locator includes {{ ... }}, it’s evaluated at runtime and passed to page.locator(...).
    • Example:
    text={{ vars.buttonText }}
    This becomes a dynamic string at runtime, supporting mixes like: 
    [data-cy="btn-{{ vars.action }}-{{ env.SEGMENT }}"]
  • Functional locators (Playwright API style): When your step stores a functional locator (e.g., getByRole, getByTestId, locator(...) chains), expressions are supported only inside quoted string literals. The rest of the call remains code-safe.
    • Example:
    getByRole('button', { name: '{{ vars.submitLabel }}' })
    At runtime, only the quoted string literal is evaluated, keeping the function call intact.

​
Notes and safeguards

  • Expressions are evaluated at runtime using the same sources (env, vars, random).
  • For functional locators, only quoted string literals are transformed. Non‑string parts (objects, function names) are preserved to avoid code injection and keep type safety.
  • Prefer concise expressions; move complex logic to a prior step (e.g., Capture Value or Run Python) and reference via vars.*.

​
Best practices

  • Ensure the variable exists before use (the step that creates it must run earlier)
  • Keep expressions concise; move complex logic to a “Run Python” step when needed
  • Do not attempt to assign to env.* (read‑only)
  • Prefer strip()/lower() for robust comparisons in verifications

​
How to use in Run Python

In the Run Python step you do not use {{ }}. The following are directly available:
  • env.* (read‑only)
  • vars.*
  • random.*
Use this step for multi‑line logic, loops, mappings, or to set new variables for later steps. Run JavaScript globals

​
Troubleshooting

  • Variable not found: confirm the producing step ran earlier and saved a variable
  • Quote handling: prefer {{ ... }} without additional quotes; the editor handles string composition
  • Curly braces: make sure both {{ and }} are present and balanced
⌘I