Dynamic URL Replacement

As a QA Engineer, you may need to run test cases on different environments (e.g., staging, production) without altering your test scripts. With Dynamic URL Replacement you can execute the same test cases across multiple environments without modifying the test scripts, ensuring seamless execution across different environments.

This feature is applicable only for Web Tests

Prerequisites

You must have created a test run for KaneAI Generated Tests.

How to Use Dynamic URL Replacement

Step 1: Navigate to the Test Runs Page

• Log in to LambdaTest.
• Go to the Test Manager > Test Runs section.
• Click on your desired Test Run.
• Click on Run with HyperExecute button.

Step 2: Configure the Test Execution URL

• In the Run on HyperExecute side drawer, locate the new field labeled Replace Test Execution URL.
• Enter the Pattern URL (your original URL used in the tests) and Replacement URL (URL of different environment you want to test) in the text field.

You can add multiple URLs for all web tests in the run to execute in different environments

Step 3: Execute the Test Run

• If the Replace Test Execution URL field is filled, the entered URL will override the default (Pattern) URL during execution.
• If left empty, the test will run with the default URL.
• Click on the Execute button

How to Use Dynamic URL Replacement via API

If you prefer to use the API to configure and execute tests with Dynamic URL Replacement, follow the instructions below:

API Endpoint

POST request

https://test-manager-api.lambdatest.com/api/atm/v1/hyperexecute

Request Headers

Content-Type: application/json
Authorization: Basic <Base64Auth>

Request Body

The following JSON payload demonstrates how to use the API to configure Dynamic URL Replacement:

{
  "test_run_id": "YOUR_TEST_RUN_ID", // Replace with your test run ID
  "concurrency": 1, // Optional, Default: 1
  "title": "UNIQUE_BUILD_NAME", // Optional
  "region": "YOUR_DESIRED_REGION", // e.g., eastus, centralindia
  "replaced_url": [
      {
          "pattern_url": "TEST_URL_1",
          "replacement_url": "REPLACED_TEST_URL_1"
      },
      {
          "pattern_url": "TEST_URL_2",
          "replacement_url": "REPLACED_TEST_URL_2"
      },
      {
          "pattern_url": "TEST_URL_3",
          "replacement_url": "REPLACED_TEST_URL_3"
      }
  ],
  "accessibility": false
}

Parameters Explained

Parameter	Description
test_run_id	The unique identifier for the test run.
concurrency	(Optional) Number of parallel executions. Default is 1.
title	(Optional) A unique name for the build.
region	The region where the tests will be executed (e.g., eastus, centralindia).
replaced_url	An array of objects containing pattern_url and replacement_url
accessibility	(Optional) Enable or disable accessibility testing.

Example cURL Command

Here’s an example cURL command to trigger a test run with Dynamic URL Replacement:

curl --location 'https://test-manager-api.lambdatest.com/api/atm/v1/hyperexecute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic <Base64Auth>' \
--data '{
    "test_run_id": "YOUR_TEST_RUN_ID", 
    "concurrency": 1, 
    "title": "UNIQUE_BUILD_NAME", 
    "region": "eastus", 
    "replaced_url": [
        {
            "pattern_url": "lambdatest",
            "replacement_url": "ajio"
        },
        {
            "pattern_url": "d",
            "replacement_url": "flipkart"
        },
        {
            "pattern_url": "hello",
            "replacement_url": "1234"
        }
    ],
    "accessibility": false
}'

• Replace <Base64Auth> with your actual Base64-encoded authorization credentials.
• Ensure that the pattern_url matches the exact URL pattern used in your test scripts.
• Multiple replaced_url entries can be added to replace different URLs dynamically.